contextsynapse 1.0.0__py3-none-any.whl

contextsynapse/tests/regression/cases/test_blockchain_latest_block.yaml

@@ -0,0 +1,35 @@
+id: test_blockchain_003
+name: Blockchain - Get Latest Block
+description: 'Tests GET LATEST BLOCK query to get the most recent block.
+
+  Requires traceability to be enabled.
+
+  '
+query: 'CREATE NODE TestNode { name: "test_node_1" };
+
+  CREATE NODE TestNode { name: "test_node_2" };
+
+
+  GET LATEST BLOCK'
+namespace: blockchain_test
+expected_success: true
+tags:
+- blockchain
+- traceability
+- latest_block
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests GET LATEST BLOCK query.
+
+  Requires traceability to be enabled.
+
+  Should return the most recent blockchain block.
+
+  '
+skip: true
+skip_reason: Traceability layer not enabled in default configuration
+priority: 6
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_blockchain_length.yaml

@@ -0,0 +1,37 @@
+id: test_blockchain_002
+name: Blockchain - Get Blockchain Length
+description: 'Tests GET BLOCKCHAIN LENGTH query to get number of blocks.
+
+  Requires traceability to be enabled.
+
+  '
+query: 'CREATE NODE TestNode { name: "test_node_1" };
+
+  CREATE NODE TestNode { name: "test_node_2" };
+
+  CREATE NODE TestNode { name: "test_node_3" };
+
+
+  GET BLOCKCHAIN LENGTH'
+namespace: blockchain_test
+expected_success: true
+tags:
+- blockchain
+- traceability
+- length
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests GET BLOCKCHAIN LENGTH query.
+
+  Requires traceability to be enabled.
+
+  Should return number of blocks created.
+
+  '
+skip: true
+skip_reason: Traceability layer not enabled in default configuration
+priority: 6
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_blockchain_merkle_root.yaml

@@ -0,0 +1,37 @@
+id: test_blockchain_006
+name: Blockchain - Get Merkle Root
+description: 'Tests GET MERKLE ROOT query to get Merkle tree root hash.
+
+  Requires traceability to be enabled.
+
+  '
+query: 'CREATE NODE TestNode { name: "test_node_1" };
+
+  CREATE NODE TestNode { name: "test_node_2" };
+
+  CREATE NODE TestNode { name: "test_node_3" };
+
+
+  GET MERKLE ROOT'
+namespace: blockchain_test
+expected_success: true
+tags:
+- blockchain
+- traceability
+- merkle_root
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests GET MERKLE ROOT query.
+
+  Requires traceability to be enabled.
+
+  Should return Merkle tree root hash.
+
+  '
+skip: true
+skip_reason: Traceability layer not enabled in default configuration
+priority: 6
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_blockchain_verify.yaml

@@ -0,0 +1,35 @@
+id: test_blockchain_001
+name: Blockchain - Verify Blockchain Integrity
+description: 'Tests VERIFY BLOCKCHAIN query to verify blockchain integrity.
+
+  Requires traceability to be enabled.
+
+  '
+query: 'CREATE NODE TestNode { name: "test_node_1", value: 100 };
+
+  CREATE NODE TestNode { name: "test_node_2", value: 200 };
+
+
+  VERIFY BLOCKCHAIN'
+namespace: blockchain_test
+expected_success: true
+tags:
+- blockchain
+- traceability
+- verify
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests VERIFY BLOCKCHAIN query.
+
+  Requires traceability to be enabled in graph configuration.
+
+  Verifies blockchain integrity after creating nodes.
+
+  '
+skip: true
+skip_reason: Traceability layer not enabled in default configuration
+priority: 6
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_blockchain_verify_block.yaml

@@ -0,0 +1,35 @@
+id: test_blockchain_005
+name: Blockchain - Verify Specific Block
+description: 'Tests VERIFY BLOCK query to verify integrity of a specific block.
+
+  Requires traceability to be enabled.
+
+  '
+query: 'CREATE NODE TestNode { name: "test_node_1" };
+
+  CREATE NODE TestNode { name: "test_node_2" };
+
+
+  VERIFY BLOCK 1'
+namespace: blockchain_test
+expected_success: true
+tags:
+- blockchain
+- traceability
+- verify_block
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests VERIFY BLOCK query with specific block index.
+
+  Requires traceability to be enabled.
+
+  Should verify block integrity.
+
+  '
+skip: true
+skip_reason: Traceability layer not enabled in default configuration
+priority: 6
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_create_edge.yaml

@@ -0,0 +1,28 @@
+id: test_004
+name: CREATE EDGE - Basic (Query-Scoped Aliases)
+description: Tests edge creation using query-scoped aliases within a single query
+query: |
+  CREATE NODE TestNode AS source_node { name: "edge_test_source" };
+  CREATE NODE TestNode AS target_node { name: "edge_test_target" };
+  CREATE EDGE CONNECTS SRC source_node DEST target_node { weight: 1.0 }
+namespace: regression_test
+expected_success: true
+expected_nodes: 0
+expected_edges: 1
+tags:
+- basic
+- create
+- edge
+- query_scoped_aliases
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: |
+  Tests edge creation using query-scoped aliases (AS clause).
+  Aliases exist only during query execution and are not persisted.
+  This demonstrates the query-scoped alias pattern where CREATE NODE AS alias
+  and CREATE EDGE can reference those aliases within the same query.
+priority: 2
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_delete_edge_basic.yaml

@@ -0,0 +1,29 @@
+id: test_delete_001
+name: DELETE EDGE - Basic
+description: Tests basic DELETE EDGE query to remove edges from the graph
+query: |
+  CREATE NODE Person AS p1 { name: "Alice" };
+  CREATE NODE Person AS p2 { name: "Bob" };
+  CREATE EDGE KNOWS SRC p1 DEST p2 { weight: 1.0, since: 2020 };
+  DELETE EDGE KNOWS WHERE source.name = "Alice" AND target.name = "Bob"
+namespace: regression_test
+expected_success: true
+expected_nodes: 0
+expected_edges: 0
+tags:
+- basic
+- delete
+- edge
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: |
+  Tests DELETE EDGE query that was recently fixed.
+  Creates an edge and then deletes it using WHERE conditions.
+  Verifies that DELETE EDGE correctly removes edges matching conditions.
+priority: 2
+prerequisites: []
+requires_data: false
+requires_files: []
+
+

contextsynapse/tests/regression/cases/test_delete_node_basic.yaml

@@ -0,0 +1,29 @@
+id: test_delete_002
+name: DELETE NODE - Basic
+description: Tests basic DELETE NODE query to remove nodes from the graph
+query: |
+  CREATE NODE Person { name: "Alice", age: 30 };
+  CREATE NODE Person { name: "Bob", age: 25 };
+  CREATE NODE Person { name: "Charlie", age: 35 };
+  DELETE NODE Person WHERE age > 30
+namespace: regression_test
+expected_success: true
+expected_nodes: 0
+expected_edges: null
+tags:
+- basic
+- delete
+- node
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: |
+  Tests DELETE NODE query to remove nodes matching WHERE conditions.
+  Creates multiple nodes and deletes those matching the condition.
+  Verifies that DELETE NODE correctly removes nodes.
+priority: 2
+prerequisites: []
+requires_data: false
+requires_files: []
+
+

contextsynapse/tests/regression/cases/test_evaluation_mrr.yaml

@@ -0,0 +1,40 @@
+id: test_eval_004
+name: Evaluation - MRR (Mean Reciprocal Rank)
+description: 'Tests MRR evaluation metric.
+
+  Measures position of first relevant result.
+
+
+  Evaluation flow:
+
+  1. Execute multiple RAG queries
+
+  2. Find first relevant result position
+
+  3. Calculate reciprocal rank
+
+  4. Average across queries
+
+  '
+namespace: regression_test
+expected_success: true
+query: ''
+tags:
+- evaluation
+- mrr
+- ranking
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests MRR evaluation metric.
+
+  Measures average reciprocal rank of first relevant result.
+
+  Uses explicit embedding model.
+
+  '
+priority: 5
+prerequisites:
+- RUN_INGESTION_PIPELINE
+requires_data: true
+requires_files: []

contextsynapse/tests/regression/cases/test_evaluation_ndcg.yaml

@@ -0,0 +1,40 @@
+id: test_eval_002
+name: Evaluation - NDCG (Normalized Discounted Cumulative Gain)
+description: 'Tests NDCG evaluation metric.
+
+  Measures ranking quality considering position.
+
+
+  Evaluation flow:
+
+  1. Execute RAG query
+
+  2. Get relevance scores
+
+  3. Calculate NDCG@k
+
+  4. Report scores
+
+  '
+namespace: regression_test
+expected_success: true
+query: ''
+tags:
+- evaluation
+- ndcg
+- ranking
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests NDCG evaluation metric.
+
+  Measures ranking quality with position discounting.
+
+  Uses explicit embedding model.
+
+  '
+priority: 5
+prerequisites:
+- RUN_INGESTION_PIPELINE
+requires_data: true
+requires_files: []

contextsynapse/tests/regression/cases/test_evaluation_precision.yaml

@@ -0,0 +1,40 @@
+id: test_eval_001
+name: Evaluation - Precision@K
+description: 'Tests precision@k evaluation metric.
+
+  Measures relevance of top-k results.
+
+
+  Evaluation flow:
+
+  1. Execute RAG query
+
+  2. Get ground truth relevance labels
+
+  3. Calculate precision@k for k=1,5,10
+
+  4. Report scores
+
+  '
+namespace: regression_test
+expected_success: true
+query: ''
+tags:
+- evaluation
+- precision
+- metrics
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests precision@k evaluation metric.
+
+  Measures how many of top-k results are relevant.
+
+  Uses explicit embedding model.
+
+  '
+priority: 5
+prerequisites:
+- RUN_INGESTION_PIPELINE
+requires_data: true
+requires_files: []

contextsynapse/tests/regression/cases/test_evaluation_recall.yaml

@@ -0,0 +1,40 @@
+id: test_eval_003
+name: Evaluation - Recall@K
+description: 'Tests recall@k evaluation metric.
+
+  Measures coverage of relevant results.
+
+
+  Evaluation flow:
+
+  1. Execute RAG query
+
+  2. Identify all relevant documents
+
+  3. Calculate recall@k
+
+  4. Report scores
+
+  '
+namespace: regression_test
+expected_success: true
+query: ''
+tags:
+- evaluation
+- recall
+- coverage
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: 'Tests recall@k evaluation metric.
+
+  Measures how many relevant documents are retrieved.
+
+  Uses explicit embedding model.
+
+  '
+priority: 5
+prerequisites:
+- RUN_INGESTION_PIPELINE
+requires_data: true
+requires_files: []

contextsynapse/tests/regression/cases/test_group_by_basic.yaml

@@ -0,0 +1,56 @@
+id: test_groupby_001
+name: GROUP BY - Basic Aggregation
+description: Tests SELECT with GROUP BY clause for basic aggregation by department
+query: |
+  CREATE NODE Employee { name: "Alice", department: "Engineering", salary: 100000 };
+  CREATE NODE Employee { name: "Bob", department: "Engineering", salary: 110000 };
+  CREATE NODE Employee { name: "Charlie", department: "Sales", salary: 90000 };
+  CREATE NODE Employee { name: "David", department: "Sales", salary: 95000 };
+  
+  SELECT department, COUNT(*), AVG(salary) 
+  FROM Employee 
+  GROUP BY department
+namespace: groupby_test
+expected_success: true
+expected_nodes: 2
+tags:
+- group_by
+- aggregation
+- basic
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: Tests basic GROUP BY with COUNT and AVG aggregations
+skip: false
+priority: 3
+prerequisites: []
+requires_data: false
+requires_files: []
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

contextsynapse/tests/regression/cases/test_match_node_basic.yaml

@@ -0,0 +1,29 @@
+id: test_match_001
+name: MATCH NODE - Basic
+description: Tests basic MATCH NODE query to find nodes by label and conditions
+query: |
+  CREATE NODE Person { name: "Alice", age: 30, city: "New York" };
+  CREATE NODE Person { name: "Bob", age: 25, city: "Boston" };
+  CREATE NODE Person { name: "Charlie", age: 35, city: "New York" };
+  MATCH NODE Person WHERE age > 28 AND city = "New York" LIMIT 10
+namespace: regression_test
+expected_success: true
+expected_nodes: 2
+expected_edges: null
+tags:
+- basic
+- match
+- query
+- node
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: |
+  Tests the new MATCH NODE syntax that was recently fixed.
+  Creates test data and then matches nodes based on WHERE conditions.
+  Verifies that MATCH NODE correctly filters nodes by label and properties.
+priority: 2
+prerequisites: []
+requires_data: false
+requires_files: []
+

contextsynapse/tests/regression/cases/test_match_node_with_order_limit.yaml

@@ -0,0 +1,31 @@
+id: test_match_002
+name: MATCH NODE - With ORDER BY and LIMIT
+description: Tests MATCH NODE query with ORDER BY and LIMIT clauses
+query: |
+  CREATE NODE Product { name: "Product A", price: 100, stock: 50 };
+  CREATE NODE Product { name: "Product B", price: 200, stock: 30 };
+  CREATE NODE Product { name: "Product C", price: 150, stock: 40 };
+  CREATE NODE Product { name: "Product D", price: 80, stock: 60 };
+  MATCH NODE Product AS p WHERE price > 90 RETURN p ORDER BY price DESC LIMIT 2
+namespace: regression_test
+expected_success: true
+expected_nodes: 2
+expected_edges: null
+tags:
+- basic
+- match
+- query
+- node
+- order_by
+- limit
+verify_persistence: false
+test_both_modes: true
+approved_by: system
+notes: |
+  Tests MATCH NODE with ORDER BY and LIMIT clauses.
+  Verifies that results are sorted correctly and limited to specified count.
+priority: 2
+prerequisites: []
+requires_data: false
+requires_files: []
+

contextsynapse/tests/regression/cases/test_namespace_switch.yaml

@@ -0,0 +1,18 @@
+id: test_003
+name: USE NAMESPACE - Switch
+description: Tests namespace switching
+query: 'CREATE NODE TestNode { name: "switched_test", value: 100 }'
+namespace: regression_test
+expected_success: true
+expected_nodes: 1
+tags:
+- namespace
+- switch
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: Tests namespace switching functionality. Uses double quotes for strings.
+priority: 0
+prerequisites: []
+requires_data: false
+requires_files: []

contextsynapse/tests/regression/cases/test_pipeline_cascaded.yaml

@@ -0,0 +1,61 @@
+id: test_pipeline_012
+name: Pipeline - Cascaded Pipeline Execution
+description: 'Tests cascaded pipeline where one pipeline depends on another.
+
+  First pipeline extracts and chunks documents.
+
+  Second pipeline processes chunks with entity extraction and embedding.
+
+  Uses GPT-3.5-Turbo for chunking and entity extraction.
+
+  Uses text-embedding-ada-002 for embeddings.
+
+  '
+query: "-- First pipeline: Extract and chunk\nCREATE PIPELINE extract_and_chunk_pipeline\n\
+  IN NAMESPACE cascaded_pipeline_test\nSOURCE COLLECTION raw_docs\nTARGET COLLECTION\
+  \ chunked_docs\nDESCRIPTION \"First pipeline: Extract and chunk documents\"\nCHECKPOINT\
+  \ POLICY enabled\nSTAGES = [\n  STEP extract\n      EXTRACT FROM FILE \"input-doc/annual-report-2024-2025.pdf\"\
+  \n      USING READER \"AUTO\"\n      PARAMETERS (max_pages: 10),\n  \n  STEP chunk\n\
+  \      CHUNK BY semantic\n      USING MODEL \"gpt-3.5-turbo\"\n      PROMPT \"Split\
+  \ text into semantic chunks preserving meaning.\"\n      PARAMETERS (max_tokens:\
+  \ 1000, overlap: 100)\n      STORE AS NODE TYPE Chunk\n      LINK TO Document ON\
+  \ HAS_CHUNK\n];\n\n-- Second pipeline: Process chunks (depends on first pipeline)\n\
+  CREATE PIPELINE process_chunks_pipeline\nIN NAMESPACE cascaded_pipeline_test\nSOURCE\
+  \ COLLECTION chunked_docs\nTARGET COLLECTION knowledge_graph\nDESCRIPTION \"Second\
+  \ pipeline: Process chunks with entities and embeddings\"\nCHECKPOINT POLICY enabled\n\
+  STAGES = [\n  STEP extract_entities\n      EXTRACT ENTITIES FROM CHUNKS\n      USING\
+  \ LLM \"gpt-3.5-turbo\"\n      PROMPT \"Extract entities: ORGANIZATION, PERSON,\
+  \ LOCATION, FINANCIAL_METRIC.\"\n      STORE AS NODE TYPE Entity\n      LINK TO\
+  \ Chunk ON MENTIONS,\n  \n  STEP embed\n      EMBED USING MODEL \"text-embedding-ada-002\"\
+  \n      PARAMETERS (dimensions: 1536, normalize: true)\n      STORE EMBEDDING IN\
+  \ Chunk.embedding,\n  \n  STEP index\n      INDEX USING {bm25: true, vector: true,\
+  \ graph: true}\n];\n\n-- Run first pipeline\nRUN PIPELINE extract_and_chunk_pipeline;\n\
+  \n-- Run second pipeline (depends on first)\nRUN PIPELINE process_chunks_pipeline"
+namespace: cascaded_pipeline_test
+expected_success: true
+expected_nodes: 50
+expected_edges: 20
+tags:
+- pipeline
+- cascaded
+- nested
+- ingestion
+- gpt-3.5
+- embedding
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: 'Tests cascaded pipeline execution.
+
+  First pipeline extracts and chunks documents.
+
+  Second pipeline processes chunks with entity extraction and embedding.
+
+  Verifies pipeline dependencies work correctly.
+
+  '
+priority: 4
+prerequisites: []
+requires_data: false
+requires_files:
+- input-doc/annual-report-2024-2025.pdf

contextsynapse/tests/regression/cases/test_pipeline_fixed_size_chunking.yaml

@@ -0,0 +1,48 @@
+id: test_pipeline_003
+name: Pipeline - Fixed Size Chunking
+description: 'Tests ingestion pipeline with fixed-size chunking strategy.
+
+  No LLM required for chunking (faster).
+
+  Uses text-embedding-ada-002 for embeddings.
+
+  Processes 25-30 pages.
+
+  '
+query: "CREATE PIPELINE regression_fixed_size_pipeline\nIN NAMESPACE tcs_regression_pipeline\n\
+  SOURCE COLLECTION raw_docs\nTARGET COLLECTION knowledge_graph\nDESCRIPTION \"Regression\
+  \ test: Fixed-size chunking (25-30 pages)\"\nCHECKPOINT POLICY enabled\nSTAGES =\
+  \ [\n  STEP extract\n      EXTRACT FROM FILE \"input-doc/annual-report-2024-2025.pdf\"\
+  \n      USING READER \"AUTO\"\n      PARAMETERS (max_pages: 30),\n  \n  STEP chunk\n\
+  \      CHUNK BY fixed_size\n      PARAMETERS (chunk_size: 1000, overlap: 200)\n\
+  \      STORE AS NODE TYPE Chunk\n      LINK TO Document ON HAS_CHUNK,\n  \n  STEP\
+  \ embed\n      EMBED USING MODEL \"text-embedding-ada-002\"\n      PARAMETERS (dimensions:\
+  \ 1536, normalize: true)\n      STORE EMBEDDING IN Chunk.embedding,\n  \n  STEP\
+  \ index\n      INDEX USING {bm25: true, vector: true, graph: true}\n]"
+namespace: tcs_regression_pipeline
+expected_success: true
+expected_nodes: 50
+expected_edges: 10
+tags:
+- pipeline
+- ingestion
+- fixed_size_chunking
+- no_llm
+- embedding
+verify_persistence: true
+test_both_modes: true
+approved_by: system
+notes: 'Tests CREATE PIPELINE with fixed-size chunking.
+
+  No LLM required (faster processing).
+
+  Includes explicit embedding model.
+
+  Verifies fixed-size chunking works correctly.
+
+  '
+priority: 4
+prerequisites: []
+requires_data: false
+requires_files:
+- input-doc/annual-report-2024-2025.pdf