docs: restructure documentation and move scripts to scripts/

- Add docs/ hierarchy: guides, backends, operations, reference, design
- Slim root README; add documentation index and links to docs/
- Add missing docs: csv-format-flexibility, dns-resolution, dtail-metrics-example, magefile
- Document Prometheus/VictoriaMetrics and ClickHouse backends
- Move all helper shell scripts to scripts/; update Magefile and doc references
- Add ASCII diagrams for watch mode (CSV watcher), auto mode, and ingestion paths
- Add .gitignore

Co-authored-by: Cursor <cursoragent@cursor.com>

1 files changed, 6 insertions, 6 deletions

diff --git a/Magefile.go b/Magefile.go
index 3cce6e0..6a0b124 100644
--- a/Magefile.go
+++ b/Magefile.go
@@ -179,7 +179,7 @@ func Dev() error {
 // GenerateTestData creates test data files
 func GenerateTestData() error {
 	fmt.Println("Generating test data...")
-	return sh.RunV("./generate-test-data.sh")
+	return sh.RunV("./scripts/generate-test-data.sh")
 }
 
 // Backfill runs backfill for the last 48 hours
@@ -192,31 +192,31 @@ func Backfill() error {
 // Benchmark100MB runs the 100MB benchmark
 func Benchmark100MB() error {
 	fmt.Println("Running 100MB benchmark...")
-	return sh.RunV("./benchmark-100mb.sh")
+	return sh.RunV("./scripts/benchmark-100mb.sh")
 }
 
 // Benchmark1GB runs the 1GB benchmark
 func Benchmark1GB() error {
 	fmt.Println("Running 1GB benchmark...")
-	return sh.RunV("./benchmark-1gb.sh")
+	return sh.RunV("./scripts/benchmark-1gb.sh")
 }
 
 // CleanupBenchmarkData removes benchmark data from Prometheus
 func CleanupBenchmarkData() error {
 	fmt.Println("Cleaning up benchmark data...")
-	return sh.RunV("./cleanup-benchmark-data.sh")
+	return sh.RunV("./scripts/cleanup-benchmark-data.sh")
 }
 
 // CleanupBenchmarkMetrics removes benchmark metric files
 func CleanupBenchmarkMetrics() error {
 	fmt.Println("Cleaning up benchmark metric files...")
-	return sh.RunV("./cleanup-benchmark-metrics.sh")
+	return sh.RunV("./scripts/cleanup-benchmark-metrics.sh")
 }
 
 // DeployDashboard deploys the Grafana dashboard
 func DeployDashboard() error {
 	fmt.Println("Deploying Grafana dashboard...")
-	return sh.RunV("./deploy-dashboard.sh")
+	return sh.RunV("./scripts/deploy-dashboard.sh")
 }
 
 // Help prints available targets