stack

var DashboardCmd = &cobra.Command{
	Use:   "dashboard",
	Short: "Manage stack dashboard",
	Long: `Start, stop, and manage the weave stack dashboard.

The dashboard provides a web interface for interacting with your RAG stack.
It can be managed using PM2 (local/VM) or Kubernetes (cloud).

Examples:
  weave stack dashboard start     # Start dashboard with PM2
  weave stack dashboard stop      # Stop dashboard
  weave stack dashboard status    # Show dashboard status
  weave stack dashboard logs      # Stream dashboard logs`,
}

var DownCmd = &cobra.Command{
	Use:   "down",
	Short: "Stop and remove the stack",
	Long: `Stop all stack services and remove the Kubernetes cluster.

This command:
1. Uninstalls Helm releases
2. Deletes the K8s cluster
3. Cleans up state files

Example:
  weave stack down`,
	RunE: runDown,
}

var IngestCmd = &cobra.Command{
	Use:   "ingest <collection-name> <data-path>",
	Short: "Ingest data into stack collection",
	Long: `Ingest data into a collection in the deployed stack.

This command automatically connects to the Milvus instance running in your
stack and ingests documents using the existing weave ingestion pipeline.

The command will:
  1. Detect active stack from .weave-state/
  2. Port-forward to Milvus (if needed)
  3. Create collection (if doesn't exist)
  4. Ingest documents with progress tracking
  5. Show ingestion summary

Examples:
  # Ingest PDFs into Documents collection
  weave stack ingest Documents data/pdfs/

  # Ingest images with custom embedding
  weave stack ingest Images data/images/ \
    --type image \
    --embedding text-embedding-3-small

  # Parallel ingestion with custom chunk size
  weave stack ingest Docs data/ \
    --chunk-size 1000 \
    --parallel-workers 4 \
    --batch-size 20`,
	Args: cobra.ExactArgs(2),
	RunE: runIngest,
}

var InitCmd = &cobra.Command{
	Use:   "init",
	Short: "Initialize a new weave stack",
	Long: `Initialize a new weave stack by generating weave-stack.yaml.

This command creates a new stack configuration file with sensible defaults
for your chosen runtime environment (Kind, Minikube, EKS, GKE).

Templates:
  quickstart  - Minimal stack (1 collection, Milvus, local K8s)
  production  - Full stack (collections, evals, dashboard)
  multimodal  - Text + image collections
  oss         - Ollama + sentence-transformers (no API keys)

Examples:
  # Initialize with quickstart template for Kind
  weave stack init --template quickstart --runtime kind

  # Initialize for AWS EKS production
  weave stack init --template production --runtime eks

  # Initialize with defaults (quickstart + kind)
  weave stack init`,
	RunE: runInit,
}

var KubectlCmd = &cobra.Command{
	Use:   "kubectl -- <kubectl-args>",
	Short: "Run kubectl commands with stack context",
	Long: `Run kubectl commands with the stack's Kubernetes context automatically set.

This command is a convenience wrapper that automatically adds the --context flag
pointing to your stack's Kubernetes cluster, so you don't have to specify it manually.

Examples:
  weave stack kubectl -- get pods
  weave stack kubectl -- describe pod weave-stack-milvus-xyz
  weave stack kubectl -- get services
  weave stack kubectl -- logs weave-stack-milvus-xyz --follow

Note: The "--" separator is required to separate stack flags from kubectl flags.`,
	RunE:                  runKubectl,
	DisableFlagParsing:    true,
	DisableFlagsInUseLine: true,
}

var LogsCmd = &cobra.Command{
	Use:   "logs [service]",
	Short: "Stream logs from stack services",
	Long: `Stream logs from services running in the stack.

For Kubernetes deployments, this streams logs from pods.
For PM2 dashboard, use 'weave stack dashboard logs'.

Examples:
  weave stack logs milvus              # Show last 100 lines from Milvus
  weave stack logs milvus --follow     # Follow Milvus logs in real-time
  weave stack logs milvus --tail 50    # Show last 50 lines
  weave stack logs vectordb -f         # Follow vectordb logs`,
	Args: cobra.MaximumNArgs(1),
	RunE: runLogs,
}

var PortForwardCmd = &cobra.Command{
	Use:   "port-forward <service> <port-mapping>",
	Short: "Forward local port to service",
	Long: `Forward a local port to a service in the stack.

This command sets up port forwarding from your local machine to a Kubernetes
service in the stack, allowing you to access the service as if it were running locally.

The port mapping format is: LOCAL_PORT:REMOTE_PORT

Examples:
  weave stack port-forward milvus 19530:19530
  weave stack port-forward milvus 8080:19530
  weave stack port-forward vectordb 19530:19530

After running this command:
  - Access Milvus at: localhost:19530
  - Press Ctrl+C to stop port forwarding

Common Services:
  milvus:     19530 (gRPC), 9091 (metrics)
  dashboard:  3000 (HTTP)`,
	Args: cobra.ExactArgs(2),
	RunE: runPortForward,
}

var StatusCmd = &cobra.Command{
	Use:   "status",
	Short: "Show stack status",
	Long: `Show the status of the stack and its components.

Example:
  weave stack status`,
	RunE: runStatus,
}

var UpCmd = &cobra.Command{
	Use:   "up",
	Short: "Deploy the stack to Kubernetes",
	Long: `Deploy the complete RAG stack to Kubernetes.

This command:
1. Creates a K8s cluster (if needed)
2. Generates Helm charts from weave-stack.yaml
3. Deploys infrastructure (VectorDB, etc.)
4. Waits for services to be ready

Example:
  weave stack up --runtime kind
  weave stack up --runtime minikube
  weave stack up --skip-cluster-creation  # Use existing cluster`,
	RunE: runUp,
}

var ValidateCmd = &cobra.Command{
	Use:   "validate",
	Short: "Validate weave-stack.yaml configuration",
	Long: `Validate weave-stack.yaml for correctness.

This command checks:
- YAML syntax
- Required fields
- Valid values for runtime, vectordb type, etc.
- Resource specifications
- Collection schemas

Example:
  weave stack validate`,
	RunE: runValidate,
}