JSPM

@vectorforge-ai/cli

1.0.3
    • ESM via JSPM
    • ES Module Entrypoint
    • Export Map
    • Keywords
    • License
    • Repository URL
    • TypeScript Types
    • README
    • Created
    • Published
    • Downloads 9
    • Score
      100M100P100Q32996F
    • License MIT

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

    Package Exports

    • @vectorforge-ai/cli
    • @vectorforge-ai/cli/dist/index.js

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@vectorforge-ai/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    VectorForge CLI

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

    Installation

    npm install -g @vectorforge-ai/cli

    Verify the installation:

    vf --help

    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

# Register with a data type and metadata
vf register --object-id prompt:123 --content "What is AI?" --hash-mode content --data-type prompt_receipt_v1

    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 content against a registered DIVT.

    # 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 a 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 (default: 50)
    • --types <csv> - Comma-separated list of event types
    • --json - Collect events and output as JSON array

    Example Workflow

    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: Bundle with crypto signatures, worldstate, and scoring

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

    License

    MIT