doc/AGDB/AGDB_Unified_Query_Logic.md

Document 2: Unified Command Logic for AGDB

Unified Command Logic for AGDB

This document details the command structure for interacting with AGDB, covering CRUD operations, querying, managing synthetic relationships, setting policies, and more. Each command is structured in a noun-verb format, following PowerShell-style syntax.

Command Categories

1. Graph Management Commands
2. Node and Relationship Management
3. Attribute and Domain Commands
4. Query and Retrieval Commands
5. Policy Management

---

1. Graph Management Commands

create-graph

• Description: Initializes a new graph, specifying the type and metadata.
• Usage: create-graph -name "financial_time_series" -type "AGDB"
• Example:

  create-graph -name "financial_time_series" -type "AGDB" -attributes ["Open", "Close", "Volume"]
  

load-graph

• Description: Loads an existing graph from JSON or CSV.
• Usage: load-graph -file "path/to/graph.json"
• Example:

  load-graph -file "graphs/trading_data.json"
  

---

2. Node and Relationship Management

create-node

• Description: Adds a node to the graph, defining its type, domain, and attributes.
• Usage: create-node -id "node_001" -type "TimeSeriesNode" -domain "TradingData"
• Example:

  create-node -id "node_001" -attributes {"open": 50, "close": 55, "volume": 5000}
  

create-relationship

• Description: Establishes a relationship between two nodes.
• Usage: create-relationship -from "node_001" -to "node_002" -type "temporal_sequence"
• Example:

  create-relationship -from "node_001" -to "node_002" -type "next"
  

---

3.

Attribute and Domain Commands

set-attribute

• Description: Modifies or sets attributes for a node.
• Usage: set-attribute -node "node_001" -attributes {"volume": 6000}
• Example:

  set-attribute -node "node_001" -attributes {"open": 52, "high": 60}
  

set-domain

• Description: Assigns a domain to a node or graph.
• Usage: set-domain -graph "financial_time_series" -name "Trading"
• Example:

  set-domain -node "node_001" -name "Finance"
  

---

4. Query and Retrieval Commands

get-node

• Description: Retrieves data for a specific node.
• Usage: get-node -id "node_001"
• Example:

  get-node -id "node_001" -attributes ["open", "close"]
  

get-relationship

• Description: Retrieves relationships for a node.
• Usage: get-relationship -node "node_001" -type "temporal_sequence"
• Example:

  get-relationship -node "node_001" -direction "outgoing"
  

---

5. Policy Management

set-policy

• Description: Defines or updates a policy for relationship inferences.
• Usage: set-policy -name "trading_inference" -rules {"time_series_trend": {...}}
• Example:

  set-policy -name "trading_inference" -rules {"volatility_correlation": {"weight_threshold": 0.5}}
  

apply-policy

• Description: Executes a policy-based query.
• Usage: apply-policy -name "trading_inference" -target "node_001"
• Example:

  apply-policy -name "similar_patterns" -target "node_001"
  

---

Summary

This unified command structure allows for robust interaction with AGDB, enabling users to perform a wide range of operations from graph creation and management to complex query and retrieval operations. By using a straightforward noun-verb syntax, the command logic is accessible and scalable across various data structures, making AGDB a powerful tool for data-driven insights across multiple domains.