knowledge-base-cli

This crate provides the knowledge-base executable for validating, reading, querying, and updating a file-based knowledge base.

Installation

Install the executable from crates.io:

cargo install knowledge-base-cli

Every executable command reads the knowledge-base root from KNOWLEDGE_BASE_PATH:

export KNOWLEDGE_BASE_PATH="/absolute/path/to/knowledge-base"

--help and --version do not require KNOWLEDGE_BASE_PATH.

Commands

Validate the complete knowledge base:

knowledge-base validate

Read stored resources by their typed identifiers:

knowledge-base entity read Q1
knowledge-base entity-type read T1
knowledge-base property read P1
knowledge-base reference read R1
knowledge-base entity-context read Q1

Query entities using one or more typed property-value filters:

knowledge-base entity query --filter 'P3=Q2'
knowledge-base entity query --filter 'P3=Q2' --filter 'P1=228334'
knowledge-base entity query --filter 'P3=Q2' --limit 25 --offset 25

Multiple filters must all match. Results are deterministic YAML and default to 100 items from offset 0.

Inspect direct incoming, outgoing, and self-referential relationships:

knowledge-base entity relationships Q2
knowledge-base entity relationships Q2 --limit 25 --offset 25

Preview and apply a YAML statement manifest:

knowledge-base entity statement apply /tmp/statements.yaml --dry-run
knowledge-base entity statement apply /tmp/statements.yaml

An example manifest is:

statements:
  - entity: Q1
    property: P1
    value: { type: integer, value: 123456789 }
    references: [R1]

The CLI assigns statement identifiers. Each item must contain entity, property, value, and at least one reference. A batch is applied completely or not at all.

Output and exit status

Read commands write stored files to standard output exactly as written. Query and mutation commands produce deterministic YAML. Validation diagnostics and command errors are written to standard error.

Commands exit unsuccessfully when configuration is missing, input is invalid, a resource cannot be read, validation diagnostics are found, or a mutation cannot be applied.