Knowledge Commands

vrin insert "ACME Corp reported $50M revenue in Q4 2025, up 23% YoY." --title "ACME Q4"

vrin insert "long document content..." --title "Report" --no-wait --json
# {"ok": true, "data": {"job_id": "job_abc123"}}

# Check status later
vrin job job_abc123

vrin insert "content" \
  --title "Q4 Earnings" \
  --tag finance \
  --tag quarterly \
  --metadata '{"source": "SEC filing", "period": "Q4 2025"}'

vrin upload ./earnings_report.pdf

# Upload and wait for processing
vrin upload ./report.pdf

# Upload without waiting
vrin upload ./report.pdf --no-wait --json
# {"ok": true, "data": {"job_id": "job_xyz789"}}

# Upload for temporary analysis (not persisted)
vrin upload ./draft.pdf --no-save-to-memory

vrin bulk-insert ./papers.json

[
  {
    "content": "First document text...",
    "title": "Document 1",
    "tags": ["research"],
    "metadata": {"author": "Smith"}
  },
  {
    "content": "Second document text...",
    "title": "Document 2"
  }
]

# Insert 100 research papers with progress output
vrin bulk-insert ./papers.json --tag research --tag 2025

# Output:
# [1/100] completed: Adaptive-RAG: Learning to Adapt...
# [2/100] completed: Self-RAG: Learning to Retrieve...
# ...

vrin job job_abc123

# Check once
vrin job job_abc123 --json
# {"ok": true, "data": {"status": "processing", "progress": 0.6}}

# Wait for completion
vrin job job_abc123 --wait --json
# {"ok": true, "data": {"status": "completed", "facts_extracted": 47}}