@derive-ltd/uht-substrate 1.0.0

package/README.md

@@ -0,0 +1,242 @@
+# uht-substrate
+
+CLI for the [Universal Hex Taxonomy](https://factory.universalhex.org) Substrate API — classify entities, compare concepts, manage facts, and explore semantic relationships from your terminal.
+
+## Install
+
+```bash
+npm install -g uht-substrate
+```
+
+Or run without installing:
+
+```bash
+npx uht-substrate <command>
+```
+
+## Setup
+
+```bash
+uht-substrate config set token <your-api-token>
+```
+
+The default API URL is `https://substrate.universalhex.org/api`. To override:
+
+```bash
+uht-substrate config set api-url https://your-server.com/api
+```
+
+Or use environment variables:
+
+```bash
+export UHT_API_URL=https://substrate.universalhex.org/api
+export UHT_TOKEN=your-token
+```
+
+## Quick Start
+
+```bash
+# Classify an entity — get its 8-char hex code and 32 trait bits
+uht-substrate classify hammer
+uht-substrate classify "cognitive dissonance" -c "a psychology concept" --format pretty
+
+# Reclassify with a rich description (skips cache)
+uht-substrate classify "epistemic humility" \
+  -c "the intellectual virtue of recognizing the limits of one's knowledge" \
+  --force-refresh
+
+# Compare two entities — Jaccard similarity, shared/unique traits
+uht-substrate compare hammer screwdriver --format pretty
+uht-substrate compare "Account (grounds)" 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 (`-c`, `-f`, `-n`) |
+| `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 (with uuid, description) |
+| `entities get` | Get a single entity by `--name` or `--uuid` |
+| `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:
+
+```bash
+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 |
+
+```bash
+# 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 |
+
+```bash
+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 (with version) |
+| `trait-prompts` | Classifier prompts sent to the LLM (edge cases, examples) |
+| `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 |
+
+## Pipeline Integration
+
+### Semantic Impact Analysis
+
+Analyse the semantic impact of requirement changes from an [Airgen](https://airgen.io) diff. For each changed requirement, the command classifies the text using UHT and detects **semantic drift** — cases where a textual edit shifts the requirement into a different meaning-space.
+
+```bash
+# Generate a diff from airgen
+airgen diff --json > diff.json
+
+# Analyse impact
+uht-substrate impact --airgen-diff diff.json --format pretty
+uht-substrate impact --airgen-diff diff.json --json
+```
+
+The input file must be the JSON output from `airgen diff --json`, structured as `{ summary, added, removed, modified }` where each requirement has `ref` and `text` fields, and modified entries have `old_text` and `new_text`.
+
+**Pretty output:**
+
+```
+Summary: 1 added, 1 removed, 2 modified (1 with semantic drift)
+
+Semantic Drift:
+  REQ-005  40802B01 → 40846B01
+    + System-Integrated
+    + Signalling
+
+Added:
+  REQ-030  00802940  Intentionally Designed, Rule-Governed, Normative
+
+Removed:
+  REQ-010  40C06900  Synthetic, Intentionally Designed, Outputs Effect
+```
+
+**JSON output:**
+
+```json
+{
+  "summary": { "added": 1, "removed": 1, "modified": 2, "semantic_drift": 1 },
+  "drift": [{
+    "ref": "REQ-005",
+    "old_hex": "40802B01",
+    "new_hex": "40846B01",
+    "flipped_traits": [
+      { "bit": 14, "name": "System-Integrated", "direction": "added" }
+    ]
+  }],
+  "added": [{ "ref": "REQ-030", "hex": "00802940", "text": "...", "top_traits": ["..."] }],
+  "removed": [{ "ref": "REQ-010", "hex": "40C06900", "text": "...", "top_traits": ["..."] }]
+}
+```
+
+## 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`:
+
+```bash
+uht-substrate classify hammer | jq '.hex_code'
+```
+
+**Pretty** — colored terminal output:
+
+```bash
+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

package/dist/client.d.ts

@@ -0,0 +1,107 @@
+import type { Config } from "./config.js";
+export declare class ApiError extends Error {
+    status: number;
+    body: string;
+    constructor(status: number, body: string);
+}
+export declare class UHTClient {
+    private baseUrl;
+    private token;
+    verbose: boolean;
+    constructor(config: Config);
+    private request;
+    root(): Promise<unknown>;
+    info(): Promise<unknown>;
+    traits(): Promise<unknown>;
+    traitPrompts(opts?: {
+        entity_name?: string;
+        entity_description?: string;
+        bit?: number;
+    }): Promise<unknown>;
+    patterns(): Promise<unknown>;
+    classify(entity: string, opts?: {
+        context?: string;
+        use_semantic_priors?: boolean;
+        force_refresh?: boolean;
+        namespace?: string;
+        display_name?: string;
+    }): Promise<unknown>;
+    compare(entityA: string, entityB: string): Promise<unknown>;
+    batchCompare(entity: string, candidates: string[]): Promise<unknown>;
+    search(query: string, limit?: number): Promise<unknown>;
+    disambiguate(term: string, language?: string): Promise<unknown>;
+    semanticTriangle(text: string): Promise<unknown>;
+    mapPropertiesToTraits(properties: string[]): Promise<unknown>;
+    listEntities(opts?: {
+        name_contains?: string;
+        hex_pattern?: string;
+        namespace?: string;
+        limit?: number;
+        offset?: number;
+        count_only?: boolean;
+    }): Promise<unknown>;
+    getEntity(opts: {
+        name?: string;
+        uuid?: string;
+    }): Promise<unknown>;
+    deleteEntity(name: string, source?: string): Promise<unknown>;
+    deduplicateNamespace(namespace: string, dryRun?: boolean): Promise<unknown>;
+    reconcileFacts(namespace: string, tenant: string, project: string, opts?: {
+        airgen_url?: string;
+        airgen_email?: string;
+        airgen_password?: string;
+    }): Promise<unknown>;
+    inferProperties(entity: string): Promise<unknown>;
+    updateEntity(name: string, opts: {
+        display_name?: string;
+    }): Promise<unknown>;
+    getEntityHistory(name: string, limit?: number): Promise<unknown>;
+    mergeEntities(source: string, target: string): Promise<unknown>;
+    reclassifyEntity(name: string, opts?: {
+        context?: string;
+        namespace?: string;
+    }): Promise<unknown>;
+    findSimilar(entity: string, opts?: {
+        limit?: number;
+        min_shared_traits?: number;
+    }): Promise<unknown>;
+    searchByTraits(traits: Record<string, string>): Promise<unknown>;
+    createNamespace(code: string, name: string, description?: string): Promise<unknown>;
+    listNamespaces(opts?: {
+        parent?: string;
+        include_descendants?: boolean;
+    }): Promise<unknown>;
+    assignNamespace(entityName: string, namespace: string, primary?: boolean): Promise<unknown>;
+    storeFact(subject: string, predicate: string, objectValue: string, opts?: {
+        user_id?: string;
+        namespace?: string;
+    }): Promise<unknown>;
+    storeFactsBulk(facts: Array<{
+        subject: string;
+        predicate: string;
+        object_value: string;
+        user_id?: string;
+        namespace?: string;
+    }>): Promise<unknown>;
+    upsertFact(subject: string, predicate: string, objectValue: string, opts?: {
+        user_id?: string;
+        namespace?: string;
+    }): Promise<unknown>;
+    queryFacts(opts?: {
+        subject?: string;
+        object_value?: string;
+        predicate?: string;
+        category?: string;
+        user_id?: string;
+        namespace?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    updateFact(factId: string, opts?: {
+        subject?: string;
+        predicate?: string;
+        object_value?: string;
+    }): Promise<unknown>;
+    deleteFact(factId: string): Promise<unknown>;
+    getUserContext(userId?: string): Promise<unknown>;
+    getNamespaceContext(namespace: string, userId?: string): Promise<unknown>;
+}

package/dist/client.js

@@ -0,0 +1,253 @@
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`API error ${status}: ${body}`);
+        this.status = status;
+        this.body = body;
+        this.name = "ApiError";
+    }
+}
+export class UHTClient {
+    baseUrl;
+    token;
+    verbose = false;
+    constructor(config) {
+        this.baseUrl = config.apiUrl.replace(/\/+$/, "");
+        this.token = config.token || undefined;
+    }
+    async request(method, path, body, query) {
+        // Ensure baseUrl ends with / and path doesn't start with / for correct URL joining
+        const base = this.baseUrl.endsWith("/") ? this.baseUrl : this.baseUrl + "/";
+        const relativePath = path.startsWith("/") ? path.slice(1) : path;
+        const url = new URL(relativePath, base);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined && v !== "")
+                    url.searchParams.set(k, v);
+            }
+        }
+        const headers = {};
+        if (body)
+            headers["Content-Type"] = "application/json";
+        if (this.token)
+            headers["Authorization"] = `Bearer ${this.token}`;
+        if (this.verbose) {
+            console.error(`${method} ${url.toString()}`);
+            if (body)
+                console.error(JSON.stringify(body, null, 2));
+        }
+        let response;
+        try {
+            response = await fetch(url.toString(), {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            throw new Error(`Network error: could not connect to ${this.baseUrl}. Check your API URL and network connection.`);
+        }
+        if (!response.ok) {
+            const text = await response.text();
+            throw new ApiError(response.status, text);
+        }
+        return (await response.json());
+    }
+    // --- Info ---
+    async root() {
+        return this.request("GET", "/");
+    }
+    async info() {
+        return this.request("GET", "/info");
+    }
+    async traits() {
+        return this.request("GET", "/traits");
+    }
+    async traitPrompts(opts) {
+        const query = {};
+        if (opts?.entity_name)
+            query["entity_name"] = opts.entity_name;
+        if (opts?.entity_description)
+            query["entity_description"] = opts.entity_description;
+        if (opts?.bit)
+            query["bit"] = String(opts.bit);
+        return this.request("GET", "/traits/prompts", undefined, query);
+    }
+    async patterns() {
+        return this.request("GET", "/patterns");
+    }
+    // --- Classification ---
+    async classify(entity, opts) {
+        return this.request("POST", "/classify", {
+            entity,
+            context: opts?.context ?? "",
+            use_semantic_priors: opts?.use_semantic_priors ?? false,
+            force_refresh: opts?.force_refresh ?? false,
+            namespace: opts?.namespace ?? "",
+            display_name: opts?.display_name ?? "",
+        });
+    }
+    // --- Comparison ---
+    async compare(entityA, entityB) {
+        return this.request("POST", "/compare", { entity_a: entityA, entity_b: entityB });
+    }
+    async batchCompare(entity, candidates) {
+        return this.request("POST", "/batch-compare", { entity, candidates });
+    }
+    // --- Search ---
+    async search(query, limit) {
+        return this.request("POST", "/search", { query, limit: limit ?? 10 });
+    }
+    async disambiguate(term, language) {
+        return this.request("POST", "/disambiguate", { term, language: language ?? "en" });
+    }
+    async semanticTriangle(text) {
+        return this.request("POST", "/semantic-triangle", { text });
+    }
+    async mapPropertiesToTraits(properties) {
+        return this.request("POST", "/map-properties-to-traits", { properties });
+    }
+    // --- Entities ---
+    async listEntities(opts) {
+        const query = {};
+        if (opts?.name_contains)
+            query["name_contains"] = opts.name_contains;
+        if (opts?.hex_pattern)
+            query["hex_pattern"] = opts.hex_pattern;
+        if (opts?.namespace)
+            query["namespace"] = opts.namespace;
+        if (opts?.limit)
+            query["limit"] = String(opts.limit);
+        if (opts?.offset)
+            query["offset"] = String(opts.offset);
+        if (opts?.count_only)
+            query["count_only"] = "true";
+        return this.request("GET", "/entities", undefined, query);
+    }
+    async getEntity(opts) {
+        const query = {};
+        if (opts.name)
+            query["name"] = opts.name;
+        if (opts.uuid)
+            query["uuid"] = opts.uuid;
+        return this.request("GET", "/entities/get", undefined, query);
+    }
+    async deleteEntity(name, source) {
+        return this.request("POST", "/entities/delete", { name, source: source ?? "local" });
+    }
+    async deduplicateNamespace(namespace, dryRun = true) {
+        return this.request("POST", "/entities/deduplicate", { namespace, dry_run: dryRun });
+    }
+    async reconcileFacts(namespace, tenant, project, opts) {
+        return this.request("POST", "/facts/reconcile", {
+            namespace, tenant, project,
+            airgen_url: opts?.airgen_url ?? "",
+            airgen_email: opts?.airgen_email ?? "",
+            airgen_password: opts?.airgen_password ?? "",
+        });
+    }
+    async inferProperties(entity) {
+        return this.request("POST", "/entities/infer", { entity });
+    }
+    async updateEntity(name, opts) {
+        return this.request("POST", "/entities/update", {
+            name,
+            display_name: opts.display_name ?? "",
+        });
+    }
+    async getEntityHistory(name, limit) {
+        const query = { name };
+        if (limit)
+            query["limit"] = String(limit);
+        return this.request("GET", "/entities/history", undefined, query);
+    }
+    async mergeEntities(source, target) {
+        return this.request("POST", "/entities/merge", { source, target });
+    }
+    async reclassifyEntity(name, opts) {
+        return this.request("POST", "/entities/reclassify", {
+            name,
+            context: opts?.context ?? "",
+            namespace: opts?.namespace ?? "",
+        });
+    }
+    async findSimilar(entity, opts) {
+        return this.request("POST", "/entities/find-similar", {
+            entity,
+            limit: opts?.limit ?? 5,
+            min_shared_traits: opts?.min_shared_traits ?? 20,
+        });
+    }
+    async searchByTraits(traits) {
+        return this.request("GET", "/search/traits", undefined, traits);
+    }
+    // --- Namespaces ---
+    async createNamespace(code, name, description) {
+        return this.request("POST", "/namespaces/create", { code, name, description: description ?? "" });
+    }
+    async listNamespaces(opts) {
+        return this.request("POST", "/namespaces/list", {
+            parent: opts?.parent ?? "",
+            include_descendants: opts?.include_descendants ?? false,
+        });
+    }
+    async assignNamespace(entityName, namespace, primary) {
+        return this.request("POST", "/namespaces/assign", {
+            entity_name: entityName,
+            namespace,
+            primary: primary ?? true,
+        });
+    }
+    // --- Facts ---
+    async storeFact(subject, predicate, objectValue, opts) {
+        return this.request("POST", "/facts/store", {
+            subject,
+            predicate,
+            object_value: objectValue,
+            user_id: opts?.user_id ?? "default",
+            namespace: opts?.namespace ?? "",
+        });
+    }
+    async storeFactsBulk(facts) {
+        return this.request("POST", "/facts/store-bulk", { facts });
+    }
+    async upsertFact(subject, predicate, objectValue, opts) {
+        return this.request("POST", "/facts/upsert", {
+            subject,
+            predicate,
+            object_value: objectValue,
+            user_id: opts?.user_id ?? "default",
+            namespace: opts?.namespace ?? "",
+        });
+    }
+    async queryFacts(opts) {
+        return this.request("POST", "/facts/query", {
+            subject: opts?.subject ?? "",
+            object_value: opts?.object_value ?? "",
+            predicate: opts?.predicate ?? "",
+            category: opts?.category ?? "",
+            user_id: opts?.user_id ?? "",
+            namespace: opts?.namespace ?? "",
+            limit: opts?.limit ?? 50,
+        });
+    }
+    async updateFact(factId, opts) {
+        return this.request("POST", "/facts/update", {
+            fact_id: factId,
+            subject: opts?.subject ?? "",
+            predicate: opts?.predicate ?? "",
+            object_value: opts?.object_value ?? "",
+        });
+    }
+    async deleteFact(factId) {
+        return this.request("POST", "/facts/delete", { fact_id: factId });
+    }
+    async getUserContext(userId) {
+        return this.request("POST", "/facts/user-context", { user_id: userId ?? "default" });
+    }
+    async getNamespaceContext(namespace, userId) {
+        return this.request("POST", "/facts/namespace-context", { namespace, user_id: userId ?? "" });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAExB;IACA;IAFT,YACS,MAAc,EACd,IAAY;QAEnB,KAAK,CAAC,aAAa,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QAH/B,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAGnB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACZ,OAAO,CAAS;IAChB,KAAK,CAAqB;IAC3B,OAAO,GAAY,KAAK,CAAC;IAEhC,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAsB,EACtB,IAAY,EACZ,IAA8B,EAC9B,KAA8B;QAE9B,mFAAmF;QACnF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;oBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QACvD,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QAElE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,IAAI;gBAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBACrC,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aAC9C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,CAAC,OAAO,8CAA8C,CAClG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,eAAe;IAEf,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAA0E;QAC3F,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,IAAI,EAAE,WAAW;YAAE,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/D,IAAI,IAAI,EAAE,kBAAkB;YAAE,KAAK,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACpF,IAAI,IAAI,EAAE,GAAG;YAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,yBAAyB;IAEzB,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,IAA8H;QAC3J,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE;YACvC,MAAM;YACN,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YAC5B,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,IAAI,KAAK;YACvD,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,KAAK;YAC3C,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;YAChC,YAAY,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IAErB,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAe;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,UAAoB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,iBAAiB;IAEjB,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAc;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,QAAiB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,UAAoB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,mBAAmB;IAEnB,KAAK,CAAC,YAAY,CAAC,IAAkI;QACnJ,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,IAAI,EAAE,aAAa;YAAE,KAAK,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;QACrE,IAAI,IAAI,EAAE,WAAW;YAAE,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/D,IAAI,IAAI,EAAE,SAAS;YAAE,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACzD,IAAI,IAAI,EAAE,KAAK;YAAE,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,IAAI,EAAE,MAAM;YAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,IAAI,EAAE,UAAU;YAAE,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAsC;QACpD,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACzC,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAe;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,SAAiB,EAAE,SAAkB,IAAI;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,MAAc,EAAE,OAAe,EAAE,IAA+E;QACtJ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE;YAC9C,SAAS,EAAE,MAAM,EAAE,OAAO;YAC1B,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,EAAE;YAClC,YAAY,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;YACtC,eAAe,EAAE,IAAI,EAAE,eAAe,IAAI,EAAE;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,IAA+B;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE;YAC9C,IAAI;YACJ,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,KAAc;QACjD,MAAM,KAAK,GAA2B,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,KAAK;YAAE,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,MAAc;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,IAA+C;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,EAAE;YAClD,IAAI;YACJ,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YAC5B,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,IAAqD;QACrF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,wBAAwB,EAAE;YACpD,MAAM;YACN,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;YACvB,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE;SACjD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAA8B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,qBAAqB;IAErB,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,WAAoB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAyD;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE;YAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;YAC1B,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,IAAI,KAAK;SACxD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,SAAiB,EAAE,OAAiB;QAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE;YAChD,WAAW,EAAE,UAAU;YACvB,SAAS;YACT,OAAO,EAAE,OAAO,IAAI,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAEhB,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,SAAiB,EAAE,WAAmB,EAAE,IAA+C;QACtH,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE;YAC1C,OAAO;YACP,SAAS;YACT,YAAY,EAAE,WAAW;YACzB,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,SAAS;YACnC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAgH;QACnI,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,SAAiB,EAAE,WAAmB,EAAE,IAA+C;QACvH,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE;YAC3C,OAAO;YACP,SAAS;YACT,YAAY,EAAE,WAAW;YACzB,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,SAAS;YACnC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAA+I;QAC9J,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE;YAC1C,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YAC5B,YAAY,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;YACtC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;YAChC,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE;YAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YAC5B,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;YAChC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;SACzB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,IAAsE;QACrG,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE;YAC3C,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YAC5B,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;YAChC,YAAY,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAe;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,SAAiB,EAAE,MAAe;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;IAChG,CAAC;CACF"}

package/dist/commands/classify.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { UHTClient } from "../client.js";
+export declare function registerClassifyCommands(program: Command, getClient: () => UHTClient, getFormat: () => "json" | "pretty"): void;

package/dist/commands/classify.js

@@ -0,0 +1,29 @@
+import { output } from "../output.js";
+export function registerClassifyCommands(program, getClient, getFormat) {
+    program
+        .command("classify")
+        .description("Classify an entity and get its hex code")
+        .argument("<entity>", "Entity to classify")
+        .option("-c, --context <context>", "Additional context/description to guide classification")
+        .option("--semantic-priors", "Use semantic prior inference", false)
+        .option("-f, --force", "Reclassify in place — skip cache, update existing entity's hex code and traits", false)
+        .option("-n, --namespace <ns>", "Namespace code (e.g. 'SE', 'SE:aerospace')")
+        .option("--display-name <name>", "Short display name for presentation")
+        .action(async (entity, opts) => {
+        output(await getClient().classify(entity, {
+            context: opts.context,
+            use_semantic_priors: opts.semanticPriors,
+            force_refresh: opts.force,
+            namespace: opts.namespace,
+            display_name: opts.displayName,
+        }), getFormat());
+    });
+    program
+        .command("infer")
+        .description("Infer properties of an entity from its classification")
+        .argument("<entity>", "Entity to analyze")
+        .action(async (entity) => {
+        output(await getClient().inferProperties(entity), getFormat());
+    });
+}
+//# sourceMappingURL=classify.js.map

package/dist/commands/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/commands/classify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,wBAAwB,CACtC,OAAgB,EAChB,SAA0B,EAC1B,SAAkC;IAElC,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,yCAAyC,CAAC;SACtD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;SAC1C,MAAM,CAAC,yBAAyB,EAAE,wDAAwD,CAAC;SAC3F,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,EAAE,KAAK,CAAC;SAClE,MAAM,CAAC,aAAa,EAAE,gFAAgF,EAAE,KAAK,CAAC;SAC9G,MAAM,CAAC,sBAAsB,EAAE,4CAA4C,CAAC;SAC5E,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;SACtE,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAA6G,EAAE,EAAE;QAC9I,MAAM,CACJ,MAAM,SAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,mBAAmB,EAAE,IAAI,CAAC,cAAc;YACxC,aAAa,EAAE,IAAI,CAAC,KAAK;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,WAAW;SAC/B,CAAC,EACF,SAAS,EAAE,CACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uDAAuD,CAAC;SACpE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC/B,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/compare.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import type { UHTClient } from "../client.js";
+export declare function registerCompareCommands(program: Command, getClient: () => UHTClient, getFormat: () => "json" | "pretty"): void;