VectorForge CLI

Command-line tool for VectorForge verification, registration, and streaming.

Installation

npm install
npm run build
npm link  # Make 'vf' command available globally

Configuration

Set environment variables:

export VF_API_BASE_URL=https://api.vectorforge.ai
export VF_API_KEY=vf_prod_...

Or use CLI flags: --base-url and --api-key

Commands

vf register

Register content to create a DIVT (Digital Integrity Verification Token).

# Register a JSON file
vf register --object-id doc-123 --file data.json --hash-mode json

# Register content directly
vf register --object-id doc-456 --content '{"foo":"bar"}' --hash-mode json

# Register text content
vf register --object-id text-789 --content "Hello world" --hash-mode content

Options:

• --object-id <id> - Object identifier (required)
• --file <path> - Path to file to register
• --content <data> - Content to register (alternative to --file)
• --hash-mode <mode> - Hash mode: json, content, embedding, image (default: json)
• --data-type <type> - Data type (e.g., prompt_receipt_v1)
• --json - Output raw JSON response

vf verify

Verify a DIVT against content.

# Verify with a file
vf verify --divt-id 01933e42-... --file data.json

# Verify with content directly
vf verify --divt-id 01933e42-... --content '{"foo":"bar"}'

Options:

• --divt-id <id> - DIVT identifier (required)
• --file <path> - Path to file to verify
• --content <data> - Content to verify (alternative to --file)
• --json - Output raw JSON response

Exit code: 0 if verified, 1 if not verified or error.

vf bundle

Get verification bundle (AI receipt) for a DIVT or object.

# Get bundle by DIVT ID
vf bundle --divt-id 01933e42-...

# Get bundle by object ID
vf bundle --object-id doc-123

# Include full history
vf bundle --divt-id 01933e42-... --include-history

# Save to file
vf bundle --divt-id 01933e42-... --output bundle.json

Options:

• --divt-id <id> - DIVT identifier
• --object-id <id> - Object identifier
• --include-history - Include full worldstate history
• --output <path> - Write full JSON bundle to file
• --json - Output raw JSON response to stdout

vf stream

Stream recent events via Server-Sent Events (SSE).

# Stream recent events
vf stream

# Stream with filters
vf stream --limit 10 --types scoring_event,divt_registered

# Stream since a specific time
vf stream --since 2025-11-20T10:00:00Z

Options:

• --since <iso8601> - Only fetch events since this timestamp
• --limit <n> - Maximum number of events to fetch (default: 50)
• --types <csv> - Comma-separated list of event types
• --json - Collect events and output as JSON array

Examples

# Full workflow example
export VF_API_BASE_URL=https://api.vectorforge.ai
export VF_API_KEY=vf_prod_...

# 1. Register content
vf register --object-id demo-doc --file document.json --hash-mode json
# Output: DIVT ID: 01933e42-...

# 2. Verify content
vf verify --divt-id 01933e42-... --file document.json
# Output: ✓ Verification PASSED

# 3. Get verification bundle
vf bundle --divt-id 01933e42-...
# Output: Human-readable bundle with crypto + scoring + worldstate

# 4. Stream recent events
vf stream --limit 5
# Output: Live stream of recent events

Development

# Build
npm run build

# Watch mode
npm run dev

License

MIT