@derive-ltd/uht-substrate 1.0.0

package/dist/commands/semantic.d.ts

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

package/dist/commands/semantic.js

@@ -0,0 +1,34 @@
+import { output } from "../output.js";
+export function registerSemanticCommands(program, getClient, getFormat) {
+    program
+        .command("search")
+        .description("Semantic search for similar entities")
+        .argument("<query>", "Search query")
+        .option("-l, --limit <n>", "Max results", "10")
+        .action(async (query, opts) => {
+        output(await getClient().search(query, parseInt(opts.limit)), getFormat());
+    });
+    program
+        .command("disambiguate")
+        .description("Get word senses for a polysemous term")
+        .argument("<term>", "Term to disambiguate")
+        .option("--language <lang>", "Language code", "en")
+        .action(async (term, opts) => {
+        output(await getClient().disambiguate(term, opts.language), getFormat());
+    });
+    program
+        .command("semantic-triangle")
+        .description("Get the Ogden-Richards semantic triangle for a term")
+        .argument("<text>", "Text to analyze")
+        .action(async (text) => {
+        output(await getClient().semanticTriangle(text), getFormat());
+    });
+    program
+        .command("map-properties")
+        .description("Map natural language properties to candidate UHT trait bits")
+        .argument("<properties...>", "Properties to map")
+        .action(async (properties) => {
+        output(await getClient().mapPropertiesToTraits(properties), getFormat());
+    });
+}
+//# sourceMappingURL=semantic.js.map

package/dist/commands/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../src/commands/semantic.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,QAAQ,CAAC;SACjB,WAAW,CAAC,sCAAsC,CAAC;SACnD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;SACnC,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,IAAI,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAuB,EAAE,EAAE;QACvD,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,uCAAuC,CAAC;SACpD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;SAC1C,MAAM,CAAC,mBAAmB,EAAE,eAAe,EAAE,IAAI,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAA0B,EAAE,EAAE;QACzD,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,qDAAqD,CAAC;SAClE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7B,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,UAAoB,EAAE,EAAE;QACrC,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+export interface Config {
+    apiUrl: string;
+    token: string;
+    format: "json" | "pretty";
+}
+export declare function saveConfigFile(updates: Partial<Config>): void;
+export declare function showConfig(): Record<string, string>;
+export interface CliGlobalOpts {
+    apiUrl?: string;
+    token?: string;
+    format?: string;
+}
+export declare function resolveConfig(opts: CliGlobalOpts): Config;

package/dist/config.js

@@ -0,0 +1,58 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_API_URL = "https://substrate.universalhex.org/api";
+function getConfigDir() {
+    const xdg = process.env["XDG_CONFIG_HOME"];
+    return xdg ? join(xdg, "uht-substrate") : join(homedir(), ".config", "uht-substrate");
+}
+function getConfigPath() {
+    return join(getConfigDir(), "config.json");
+}
+function loadConfigFile() {
+    const path = getConfigPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfigFile(updates) {
+    const dir = getConfigDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const existing = loadConfigFile();
+    const merged = { ...existing, ...updates };
+    writeFileSync(getConfigPath(), JSON.stringify(merged, null, 2) + "\n");
+}
+export function showConfig() {
+    const file = loadConfigFile();
+    return {
+        "Config file": getConfigPath(),
+        "apiUrl": file.apiUrl ?? `(default) ${DEFAULT_API_URL}`,
+        "token": file.token ? "***" + file.token.slice(-4) : "(not set)",
+        "format": file.format ?? "(default) json",
+        "env UHT_API_URL": process.env["UHT_API_URL"] ?? "(not set)",
+        "env UHT_TOKEN": process.env["UHT_TOKEN"] ? "***" : "(not set)",
+    };
+}
+export function resolveConfig(opts) {
+    const file = loadConfigFile();
+    return {
+        apiUrl: opts.apiUrl ??
+            process.env["UHT_API_URL"] ??
+            file.apiUrl ??
+            DEFAULT_API_URL,
+        token: opts.token ??
+            process.env["UHT_TOKEN"] ??
+            file.token ??
+            "",
+        format: opts.format ??
+            file.format ??
+            "json",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,eAAe,GAAG,wCAAwC,CAAC;AAEjE,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAoB,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,aAAa,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,OAAO;QACL,aAAa,EAAE,aAAa,EAAE;QAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa,eAAe,EAAE;QACvD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;QAChE,QAAQ,EAAE,IAAI,CAAC,MAAM,IAAI,gBAAgB;QACzC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,WAAW;QAC5D,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW;KAChE,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,OAAO;QACL,MAAM,EACJ,IAAI,CAAC,MAAM;YACX,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YAC1B,IAAI,CAAC,MAAM;YACX,eAAe;QACjB,KAAK,EACH,IAAI,CAAC,KAAK;YACV,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YACxB,IAAI,CAAC,KAAK;YACV,EAAE;QACJ,MAAM,EACH,IAAI,CAAC,MAA2B;YACjC,IAAI,CAAC,MAAM;YACX,MAAM;KACT,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { Command } from "commander";
+import { ApiError, UHTClient } from "./client.js";
+import { resolveConfig } from "./config.js";
+import { registerClassifyCommands } from "./commands/classify.js";
+import { registerCompareCommands } from "./commands/compare.js";
+import { registerEntityCommands } from "./commands/entities.js";
+import { registerSemanticCommands } from "./commands/semantic.js";
+import { registerFactCommands } from "./commands/facts.js";
+import { registerNamespaceCommands } from "./commands/namespaces.js";
+import { registerInfoCommands } from "./commands/info.js";
+import { registerConfigCommands } from "./commands/config.js";
+import { registerImpactCommand } from "./commands/impact.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const program = new Command();
+program
+    .name("uht-substrate")
+    .description("CLI for the Universal Hex Taxonomy Substrate API")
+    .version(pkg.version)
+    .option("--api-url <url>", "API base URL")
+    .option("--token <token>", "Bearer token for authentication")
+    .option("--format <fmt>", "Output format: json or pretty", "json")
+    .option("--verbose", "Show request/response details", false);
+let _client;
+function getClient() {
+    if (!_client) {
+        const opts = program.opts();
+        const config = resolveConfig(opts);
+        _client = new UHTClient(config);
+        _client.verbose = opts.verbose ?? false;
+    }
+    return _client;
+}
+function getFormat() {
+    const opts = program.opts();
+    const config = resolveConfig(opts);
+    return config.format;
+}
+// Register all commands
+registerInfoCommands(program, getClient, getFormat);
+registerClassifyCommands(program, getClient, getFormat);
+registerCompareCommands(program, getClient, getFormat);
+registerEntityCommands(program, getClient, getFormat);
+registerSemanticCommands(program, getClient, getFormat);
+registerFactCommands(program, getClient, getFormat);
+registerNamespaceCommands(program, getClient, getFormat);
+registerConfigCommands(program);
+registerImpactCommand(program, getClient, getFormat);
+// Global error handler
+function handleError(err) {
+    if (err instanceof ApiError) {
+        if (err.status === 401) {
+            console.error("Authentication failed. Set your token with:");
+            console.error("  uht-substrate config set token <your-token>");
+            console.error("  or: UHT_TOKEN=<token> uht-substrate ...");
+        }
+        else {
+            console.error(`API error (${err.status}): ${err.body}`);
+        }
+    }
+    else if (err instanceof Error) {
+        console.error(`Error: ${err.message}`);
+    }
+    else {
+        console.error(`Error: ${String(err)}`);
+    }
+    process.exit(1);
+}
+program.parseAsync(process.argv).catch(handleError);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAErF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC;KACzC,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;KAC5D,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,CAAC;KACjE,MAAM,CAAC,WAAW,EAAE,+BAA+B,EAAE,KAAK,CAAC,CAAC;AAE/D,IAAI,OAA8B,CAAC;AAEnC,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAwC,CAAC;QAClE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAiB,CAAC;IAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,wBAAwB;AACxB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACpD,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACxD,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACvD,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACtD,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACxD,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACpD,yBAAyB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACzD,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAErD,uBAAuB;AACvB,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAC/D,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;SAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,8 @@
+export declare function bold(s: string): string;
+export declare function dim(s: string): string;
+export declare function cyan(s: string): string;
+export declare function green(s: string): string;
+export declare function yellow(s: string): string;
+export declare function red(s: string): string;
+/** Print data as JSON or pretty-formatted. */
+export declare function output(data: unknown, format: "json" | "pretty"): void;

package/dist/output.js

@@ -0,0 +1,310 @@
+const NO_COLOR = !!process.env["NO_COLOR"];
+export function bold(s) {
+    return NO_COLOR ? s : `\x1b[1m${s}\x1b[0m`;
+}
+export function dim(s) {
+    return NO_COLOR ? s : `\x1b[2m${s}\x1b[0m`;
+}
+export function cyan(s) {
+    return NO_COLOR ? s : `\x1b[36m${s}\x1b[0m`;
+}
+export function green(s) {
+    return NO_COLOR ? s : `\x1b[32m${s}\x1b[0m`;
+}
+export function yellow(s) {
+    return NO_COLOR ? s : `\x1b[33m${s}\x1b[0m`;
+}
+export function red(s) {
+    return NO_COLOR ? s : `\x1b[31m${s}\x1b[0m`;
+}
+/** Print data as JSON or pretty-formatted. */
+export function output(data, format) {
+    if (format === "json") {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        prettyPrint(data);
+    }
+}
+function prettyPrint(data) {
+    if (data === null || data === undefined) {
+        console.log(dim("(empty)"));
+        return;
+    }
+    if (typeof data !== "object") {
+        console.log(String(data));
+        return;
+    }
+    const obj = data;
+    // Classification result
+    if ("hex_code" in obj && "traits" in obj) {
+        printClassification(obj);
+        return;
+    }
+    // Comparison result
+    if ("similarity" in obj && "trait_diff" in obj) {
+        printComparison(obj);
+        return;
+    }
+    // Legacy comparison format
+    if ("jaccard_similarity" in obj && "shared_traits" in obj) {
+        printComparison(obj);
+        return;
+    }
+    // Array of results
+    if (Array.isArray(data)) {
+        for (const item of data) {
+            prettyPrint(item);
+            console.log();
+        }
+        return;
+    }
+    // Traits definitions
+    if ("total_traits" in obj && "layers" in obj) {
+        printTraits(obj);
+        return;
+    }
+    // Trait prompts (full set)
+    if ("prompt_spec_version" in obj && "prompts" in obj) {
+        printTraitPrompts(obj);
+        return;
+    }
+    // Single trait prompt
+    if ("system_prompt" in obj && "trait_name" in obj) {
+        printSinglePrompt(obj);
+        return;
+    }
+    // Wrap with results/entities/facts arrays
+    if ("results" in obj && Array.isArray(obj.results)) {
+        prettyPrint(obj.results);
+        return;
+    }
+    if ("entities" in obj && Array.isArray(obj.entities)) {
+        printEntitiesTable(obj);
+        return;
+    }
+    if ("facts" in obj && Array.isArray(obj.facts)) {
+        printFactsTable(obj.facts);
+        return;
+    }
+    // Generic object
+    printObject(obj);
+}
+function printClassification(obj) {
+    const label = String(obj.name ?? obj.entity ?? "");
+    console.log(`${bold(label)}  ${cyan(String(obj.hex_code))}`);
+    if (obj.binary)
+        console.log(dim(String(obj.binary)));
+    console.log();
+    const traits = obj.traits;
+    if (traits) {
+        const present = traits.filter((t) => t.present);
+        const absent = traits.filter((t) => !t.present);
+        if (present.length) {
+            console.log(bold("Active traits:"));
+            for (const t of present) {
+                const name = String(t.name ?? t.trait ?? "");
+                const conf = typeof t.confidence === "number" ? ` ${dim(`(${(t.confidence * 100).toFixed(0)}%)`)}` : "";
+                console.log(`  ${green("+")} ${name}${conf}`);
+            }
+        }
+        const namedAbsent = absent.filter((t) => t.name || t.trait);
+        if (namedAbsent.length) {
+            console.log(bold("\nInactive traits:"));
+            for (const t of namedAbsent) {
+                const name = String(t.name ?? t.trait ?? "");
+                console.log(`  ${dim("-")} ${dim(name)}`);
+            }
+        }
+        else if (absent.length) {
+            console.log(dim(`\n${absent.length} inactive traits`));
+        }
+    }
+    const inferred = obj.inferred_properties;
+    if (inferred && Array.isArray(inferred)) {
+        console.log(bold("\nInferred properties:"));
+        for (const p of inferred) {
+            if (typeof p === "object" && p !== null) {
+                const prop = p;
+                const certainty = prop.certainty ?? prop.confidence ?? "";
+                console.log(`  ${bold(String(prop.property ?? prop.name ?? ""))} ${dim(String(certainty))}`);
+                if (prop.explanation)
+                    console.log(`    ${dim(String(prop.explanation))}`);
+            }
+        }
+    }
+    else if (inferred && typeof inferred === "object") {
+        console.log(bold("\nInferred properties:"));
+        printObject(inferred, 2);
+    }
+}
+function printComparison(obj) {
+    const entityA = String(obj.entity_a ?? "A");
+    const entityB = String(obj.entity_b ?? "B");
+    console.log(`${bold(entityA)} ${dim("vs")} ${bold(entityB)}`);
+    // Handle nested similarity object
+    const sim = (obj.similarity ?? obj);
+    const jaccard = typeof sim.jaccard_similarity === "number" ? sim.jaccard_similarity : 0;
+    const hamming = sim.hamming_distance ?? obj.hamming_distance ?? "?";
+    const color = jaccard > 0.7 ? green : jaccard > 0.3 ? yellow : red;
+    console.log(`Jaccard: ${color((jaccard * 100).toFixed(1) + "%")}  Hamming: ${hamming}`);
+    // Handle hex codes
+    const hexCodes = obj.hex_codes;
+    if (hexCodes) {
+        console.log(`${cyan(hexCodes[entityA] ?? "")} / ${cyan(hexCodes[entityB] ?? "")}`);
+    }
+    // Handle trait_diff or flat shared_traits
+    const diff = obj.trait_diff;
+    const shared = extractTraitNames(diff?.shared_traits ?? obj.shared_traits);
+    const aOnly = extractTraitNames(diff?.traits_a_only ?? obj.traits_a_only);
+    const bOnly = extractTraitNames(diff?.traits_b_only ?? obj.traits_b_only);
+    if (shared.length) {
+        console.log(bold("\nShared traits:"));
+        console.log(`  ${shared.join(", ")}`);
+    }
+    if (aOnly.length) {
+        console.log(bold(`\n${entityA} only:`));
+        console.log(`  ${aOnly.join(", ")}`);
+    }
+    if (bOnly.length) {
+        console.log(bold(`\n${entityB} only:`));
+        console.log(`  ${bOnly.join(", ")}`);
+    }
+    if (obj.comparison) {
+        console.log(`\n${dim(String(obj.comparison))}`);
+    }
+}
+function extractTraitNames(val) {
+    if (!val)
+        return [];
+    if (Array.isArray(val)) {
+        return val.map((t) => {
+            if (typeof t === "string")
+                return t;
+            if (typeof t === "object" && t !== null) {
+                const o = t;
+                return String(o.name ?? o.trait ?? "");
+            }
+            return String(t);
+        }).filter(Boolean);
+    }
+    return [];
+}
+function printTable(rows) {
+    if (!rows.length) {
+        console.log(dim("(no results)"));
+        return;
+    }
+    const cols = ["name", "hex_code", "source", "created_at"].filter((c) => rows.some((r) => r[c] !== undefined));
+    const widths = cols.map((c) => Math.max(c.length, ...rows.map((r) => String(r[c] ?? "").length)));
+    console.log(cols.map((c, i) => bold(c.padEnd(widths[i]))).join("  "));
+    console.log(cols.map((_, i) => "-".repeat(widths[i])).join("  "));
+    for (const row of rows) {
+        console.log(cols.map((c, i) => String(row[c] ?? "").padEnd(widths[i])).join("  "));
+    }
+}
+function printFactsTable(rows) {
+    if (!rows.length) {
+        console.log(dim("(no facts)"));
+        return;
+    }
+    for (const f of rows) {
+        console.log(`${cyan(String(f.subject))} ${bold(String(f.predicate))} ${cyan(String(f.object_value))}`);
+        const meta = [f.category, f.namespace, f.user_id].filter(Boolean).join(" | ");
+        if (meta)
+            console.log(`  ${dim(meta)}`);
+        if (f.id)
+            console.log(`  ${dim(String(f.id))}`);
+    }
+}
+function printTraits(obj) {
+    if (obj.version)
+        console.log(`${bold("Trait version:")} ${cyan(String(obj.version))}`);
+    console.log(`${bold("Total traits:")} ${obj.total_traits}  ${dim(String(obj.encoding ?? ""))}`);
+    console.log();
+    const layers = obj.layers;
+    if (!layers)
+        return;
+    const layerColors = {
+        physical: red,
+        functional: yellow,
+        abstract: cyan,
+        social: green,
+    };
+    for (const [layerKey, layer] of Object.entries(layers)) {
+        const colorKey = Object.keys(layerColors).find((k) => layerKey.toLowerCase().includes(k));
+        const colorFn = colorKey ? layerColors[colorKey] : bold;
+        console.log(colorFn(bold(layerKey)));
+        if (layer.description)
+            console.log(`  ${dim(String(layer.description))}`);
+        const traits = layer.traits;
+        if (traits) {
+            for (const t of traits) {
+                const bit = String(t.bit ?? "").padStart(2);
+                console.log(`  ${dim(bit)}  ${bold(String(t.name ?? ""))} ${dim("—")} ${String(t.short_description ?? "")}`);
+            }
+        }
+        console.log();
+    }
+}
+function printTraitPrompts(obj) {
+    console.log(`${bold("Prompt spec version:")} ${cyan(String(obj.prompt_spec_version ?? "?"))}`);
+    console.log(`${bold("Model:")} ${String(obj.model ?? "?")}  ${bold("Temperature:")} ${String(obj.temperature ?? "?")}`);
+    console.log(`${bold("Prompts:")} ${String(obj.count ?? "?")}`);
+    console.log();
+    const prompts = obj.prompts;
+    if (prompts) {
+        for (const p of prompts) {
+            console.log(`  ${dim(String(p.bit ?? "").padStart(2))}  ${bold(String(p.trait_name ?? ""))} ${dim(`[${p.layer}]`)}`);
+        }
+    }
+    console.log();
+    console.log(dim("Use --bit <n> to see the full prompt for a specific trait."));
+}
+function printSinglePrompt(obj) {
+    console.log(`${bold(String(obj.trait_name ?? ""))} ${dim(`[bit ${obj.bit}, ${obj.layer}]`)}`);
+    console.log();
+    console.log(String(obj.system_prompt ?? ""));
+    if (obj.user_prompt) {
+        console.log();
+        console.log(bold("User prompt:"));
+        console.log(String(obj.user_prompt));
+    }
+}
+function printEntitiesTable(obj) {
+    const total = obj.total ?? "?";
+    const offset = obj.offset ?? 0;
+    const count = obj.count ?? 0;
+    const hasMore = obj.has_more ?? false;
+    console.log(`${bold("Entities:")} ${count} of ${total}${hasMore ? dim(` (offset ${offset}, more available)`) : ""}`);
+    console.log();
+    const entities = obj.entities;
+    if (!entities || !entities.length) {
+        console.log(dim("(no results)"));
+        return;
+    }
+    for (const e of entities) {
+        const hex = cyan(String(e.hex_code ?? ""));
+        const name = bold(String(e.name ?? ""));
+        const uuid = dim(String(e.uuid ?? "").slice(0, 8));
+        console.log(`  ${uuid}  ${hex}  ${name}`);
+        if (e.description)
+            console.log(`           ${dim(String(e.description).slice(0, 100))}`);
+    }
+}
+function printObject(obj, indent = 0) {
+    const pad = " ".repeat(indent);
+    for (const [key, value] of Object.entries(obj)) {
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            console.log(`${pad}${bold(key)}:`);
+            printObject(value, indent + 2);
+        }
+        else if (Array.isArray(value)) {
+            console.log(`${pad}${bold(key)}: ${value.join(", ")}`);
+        }
+        else {
+            console.log(`${pad}${bold(key)}: ${String(value)}`);
+        }
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+/** Trait value from a classification. */
+export interface TraitValue {
+    bit_position: number;
+    name: string;
+    present: boolean;
+    confidence: number;
+    justification?: string;
+}
+/** Classification result. */
+export interface ClassificationResult {
+    uuid: string;
+    name: string;
+    hex_code: string;
+    binary: string;
+    traits: TraitValue[];
+    created_at: string;
+    inferred_properties?: Record<string, unknown>;
+}
+/** Comparison result. */
+export interface CompareResult {
+    entity_a: string;
+    entity_b: string;
+    hex_a: string;
+    hex_b: string;
+    jaccard_similarity: number;
+    hamming_distance: number;
+    shared_traits: string[];
+    traits_a_only: string[];
+    traits_b_only: string[];
+    analysis: string;
+    trait_level_diff?: Record<string, unknown>;
+}
+/** Semantic search result. */
+export interface SearchResult {
+    uuid: string;
+    name: string;
+    description?: string;
+    hex_code: string;
+    similarity_score: number;
+}
+/** Entity listing. */
+export interface Entity {
+    uuid: string;
+    name: string;
+    hex_code: string;
+    binary?: string;
+    description?: string;
+    aliases?: string[];
+    traits?: TraitValue[];
+    created_at?: string;
+}
+/** Fact record. */
+export interface Fact {
+    id: string;
+    subject: string;
+    predicate: string;
+    object_value: string;
+    category: string;
+    user_id: string;
+    namespace?: string;
+    created_at: string;
+}
+/** Namespace record. */
+export interface Namespace {
+    code: string;
+    name: string;
+    description?: string;
+    parent?: string;
+    entity_count?: number;
+}
+/** API error response. */
+export interface ApiErrorResponse {
+    error: string;
+    detail?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}