Package Exports

uht-substrate
uht-substrate/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 (uht-substrate) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

uht-substrate

CLI for the Universal Hex Taxonomy Substrate API — classify entities, compare concepts, manage facts, and explore semantic relationships from your terminal.

Install

npm install -g uht-substrate

Or run without installing:

npx uht-substrate <command>

Setup

uht-substrate config set token <your-api-token>

The default API URL is https://substrate.universalhex.org/api. To override:

uht-substrate config set api-url https://your-server.com/api

Or use environment variables:

export UHT_API_URL=https://substrate.universalhex.org/api
export UHT_TOKEN=your-token

Quick Start

# Classify an entity — get its 8-char hex code and 32 trait bits
uht-substrate classify hammer
uht-substrate classify "cognitive dissonance" --context psychology --format pretty

# Compare two entities — Jaccard similarity, shared/unique traits
uht-substrate compare hammer screwdriver --format pretty
uht-substrate compare hammer democracy --format pretty

# Batch compare — rank candidates by similarity
uht-substrate batch-compare hammer wrench screwdriver pliers saw

# Semantic search across 16k+ entities
uht-substrate search "hand tools" --limit 10

# Disambiguate a polysemous term
uht-substrate disambiguate bank

# Infer properties from classification
uht-substrate infer hammer

Commands

Classification & Reasoning

Command	Description
`classify <entity>`	Classify an entity and get its hex code
`infer <entity>`	Infer properties from classification
`compare <a> <b>`	Compare two entities
`batch-compare <entity> <candidates...>`	Compare against multiple, ranked by Jaccard
`search <query>`	Semantic search across the entity corpus
`disambiguate <term>`	Get word senses for polysemous terms
`semantic-triangle <text>`	Ogden-Richards semantic triangle decomposition
`map-properties <props...>`	Map natural language properties to UHT trait bits

Entity Management

Command	Description
`entities list`	List entities in the knowledge graph
`entities delete <name>`	Delete an entity from the local graph
`entities find-similar <entity>`	Find similar entities (experimental)
`entities explore <entity>`	Explore semantic neighborhood (experimental)
`entities search-traits`	Search entities by trait pattern

Trait search example

Use --<trait-name> to require a trait, --no-<trait-name> to exclude:

uht-substrate entities search-traits --synthetic --powered --no-biological

Fact Management

Command	Description
`facts store <subject> <predicate> <object>`	Store a fact
`facts store-bulk --file <path>`	Store multiple facts from a JSON file
`facts upsert <subject> <predicate> <object>`	Create or update a fact
`facts query`	Query facts with filters
`facts update <fact-id>`	Update an existing fact
`facts delete <fact-id>`	Delete a fact
`facts user-context`	Get a user's stored facts
`facts namespace-context <namespace>`	Get all entities and facts under a namespace

# Store a typed fact
uht-substrate facts store "spark plug" PART_OF "engine" --namespace SE:automotive

# Query facts
uht-substrate facts query --subject "spark plug" --category compositional

# Bulk store from JSON
echo '[{"subject":"bolt","predicate":"PART_OF","object_value":"frame"}]' | uht-substrate facts store-bulk -f -

Namespace Management

Command	Description
`namespaces create <code> <name>`	Create a namespace
`namespaces list`	List namespaces
`namespaces assign <entity> <namespace>`	Assign an entity to a namespace

uht-substrate namespaces create SE:automotive "Automotive Engineering"
uht-substrate namespaces assign "spark plug" SE:automotive
uht-substrate namespaces list --parent SE --descendants

Reference

Command	Description
`info`	System information and overview
`traits`	All 32 trait definitions
`patterns`	Reasoning patterns for tool orchestration

Configuration

Command	Description
`config set <key> <value>`	Set a config value (`api-url`, `token`, `format`)
`config show`	Show current configuration

Global Options

Option	Description
`--api-url <url>`	API base URL
`--token <token>`	Bearer token for authentication
`--format <fmt>`	Output format: `json` (default) or `pretty`
`--verbose`	Show request/response details
`--version`	Show version

Output Formats

JSON (default) — machine-readable, pipe to jq:

uht-substrate classify hammer | jq '.hex_code'

Pretty — colored terminal output:

uht-substrate classify hammer --format pretty

What is UHT?

The Universal Hex Taxonomy encodes any concept as a 32-bit classification (8-char hex code) across four layers:

Physical (bits 1–8): Material properties, boundaries, energy
Functional (bits 9–16): Capabilities, interfaces, state
Abstract (bits 17–24): Symbolic, temporal, rule-governed
Social (bits 25–32): Cultural, economic, institutional

Two entities with similar hex codes share similar properties. Jaccard similarity measures meaningful overlap between classifications.

License

MIT