@derive-ltd/uht-substrate 1.0.0

package/dist/commands/compare.js

@@ -0,0 +1,20 @@
+import { output } from "../output.js";
+export function registerCompareCommands(program, getClient, getFormat) {
+    program
+        .command("compare")
+        .description("Compare two entities")
+        .argument("<entity-a>", "First entity")
+        .argument("<entity-b>", "Second entity")
+        .action(async (entityA, entityB) => {
+        output(await getClient().compare(entityA, entityB), getFormat());
+    });
+    program
+        .command("batch-compare")
+        .description("Compare an entity against multiple candidates, ranked by Jaccard")
+        .argument("<entity>", "Reference entity")
+        .argument("<candidates...>", "Candidate entities to compare against")
+        .action(async (entity, candidates) => {
+        output(await getClient().batchCompare(entity, candidates), getFormat());
+    });
+}
+//# sourceMappingURL=compare.js.map

package/dist/commands/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/commands/compare.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,SAA0B,EAC1B,SAAkC;IAElC,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,sBAAsB,CAAC;SACnC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;SACtC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,EAAE;QACjD,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,kEAAkE,CAAC;SAC/E,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;SACxC,QAAQ,CAAC,iBAAiB,EAAE,uCAAuC,CAAC;SACpE,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,UAAoB,EAAE,EAAE;QACrD,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerConfigCommands(program: Command): void;

package/dist/commands/config.js

@@ -0,0 +1,36 @@
+import { saveConfigFile, showConfig } from "../config.js";
+const VALID_KEYS = {
+    "api-url": "apiUrl",
+    "token": "token",
+    "format": "format",
+};
+export function registerConfigCommands(program) {
+    const config = program
+        .command("config")
+        .description("Manage CLI configuration");
+    config
+        .command("set")
+        .description("Set a config value")
+        .argument("<key>", `Config key: ${Object.keys(VALID_KEYS).join(", ")}`)
+        .argument("<value>", "Config value")
+        .action((key, value) => {
+        const mapped = VALID_KEYS[key];
+        if (!mapped) {
+            console.error(`Unknown config key: ${key}`);
+            console.error(`Valid keys: ${Object.keys(VALID_KEYS).join(", ")}`);
+            process.exit(1);
+        }
+        saveConfigFile({ [mapped]: value });
+        console.log(`Set ${key} = ${key === "token" ? "***" : value}`);
+    });
+    config
+        .command("show")
+        .description("Show current configuration")
+        .action(() => {
+        const cfg = showConfig();
+        for (const [k, v] of Object.entries(cfg)) {
+            console.log(`${k}: ${v}`);
+        }
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,GAA2B;IACzC,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAE3C,MAAM;SACH,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,oBAAoB,CAAC;SACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACtE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;SACnC,MAAM,CAAC,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,MAAM,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/entities.d.ts

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

package/dist/commands/entities.js

@@ -0,0 +1,144 @@
+import { output } from "../output.js";
+const TRAIT_NAMES = [
+    "physical_object", "synthetic", "biological", "powered",
+    "structural", "observable", "physical_medium", "active",
+    "intentionally_designed", "outputs_effect", "processes_signals", "state_transforming",
+    "human_interactive", "system_integrated", "functionally_autonomous", "system_essential",
+    "symbolic", "signalling", "rule_governed", "compositional",
+    "normative", "meta", "temporal", "digital_virtual",
+    "social_construct", "institutionally_defined", "identity_linked", "regulated",
+    "economically_significant", "politicised", "ritualised", "ethically_significant",
+];
+export function registerEntityCommands(program, getClient, getFormat) {
+    const entities = program
+        .command("entities")
+        .description("Entity management commands");
+    entities
+        .command("list")
+        .description("List entities in the knowledge graph")
+        .option("-n, --name <filter>", "Filter by name substring")
+        .option("--hex <pattern>", "Filter by hex pattern")
+        .option("--namespace <ns>", "Filter by namespace (e.g. 'SE', 'SE:aerospace')")
+        .option("-l, --limit <n>", "Max results (or 'all')", "50")
+        .option("--offset <n>", "Skip N results", "0")
+        .option("--count-only", "Return only the total count without fetching entities")
+        .action(async (opts) => {
+        const limit = opts.limit.toLowerCase() === "all" ? 10000 : parseInt(opts.limit) || 50;
+        output(await getClient().listEntities({
+            name_contains: opts.name,
+            hex_pattern: opts.hex,
+            namespace: opts.namespace,
+            limit,
+            offset: parseInt(opts.offset),
+            count_only: opts.countOnly,
+        }), getFormat());
+    });
+    entities
+        .command("get")
+        .description("Get a single entity by name or UUID")
+        .option("-n, --name <name>", "Entity name (case-insensitive)")
+        .option("-u, --uuid <uuid>", "Entity UUID")
+        .action(async (opts) => {
+        if (!opts.name && !opts.uuid) {
+            console.error("Error: provide --name or --uuid");
+            process.exit(1);
+        }
+        output(await getClient().getEntity(opts), getFormat());
+    });
+    entities
+        .command("update")
+        .description("Update entity metadata")
+        .argument("<name>", "Exact entity name")
+        .option("--display-name <displayName>", "Short display name for presentation (empty to clear)")
+        .action(async (name, opts) => {
+        output(await getClient().updateEntity(name, { display_name: opts.displayName }), getFormat());
+    });
+    entities
+        .command("delete")
+        .description("Delete an entity and its trait edges from the local graph (facts are kept as unbound)")
+        .argument("<name>", "Exact entity name")
+        .action(async (name) => {
+        output(await getClient().deleteEntity(name), getFormat());
+    });
+    entities
+        .command("deduplicate")
+        .description("Find/remove entities that leaked from global into a namespace")
+        .requiredOption("--namespace <ns>", "Namespace to deduplicate")
+        .option("--apply", "Actually remove duplicates (default is dry run)")
+        .action(async (opts) => {
+        output(await getClient().deduplicateNamespace(opts.namespace, !opts.apply), getFormat());
+    });
+    entities
+        .command("find-similar")
+        .description("[Experimental] Find entities similar to the given entity")
+        .argument("<entity>", "Entity to find similar items for")
+        .option("-l, --limit <n>", "Max results", "5")
+        .option("--min-traits <n>", "Minimum shared traits", "20")
+        .action(async (entity, opts) => {
+        output(await getClient().findSimilar(entity, {
+            limit: parseInt(opts.limit),
+            min_shared_traits: parseInt(opts.minTraits),
+        }), getFormat());
+    });
+    entities
+        .command("merge")
+        .description("Merge source entity into target, transferring all facts and relationships")
+        .argument("<source>", "Entity to merge FROM (will be deleted)")
+        .argument("<target>", "Entity to merge INTO (will be kept)")
+        .action(async (source, target) => {
+        output(await getClient().mergeEntities(source, target), getFormat());
+    });
+    entities
+        .command("reclassify")
+        .description("Re-run classification on an existing entity, preserving UUID and facts")
+        .argument("<name>", "Exact entity name")
+        .option("-c, --context <ctx>", "Context to guide reclassification")
+        .option("-n, --namespace <ns>", "Namespace to search in")
+        .action(async (name, opts) => {
+        output(await getClient().reclassifyEntity(name, {
+            context: opts.context,
+            namespace: opts.namespace,
+        }), getFormat());
+    });
+    entities
+        .command("history")
+        .description("Show classification history of an entity")
+        .argument("<name>", "Entity name")
+        .option("-l, --limit <n>", "Max history entries", "50")
+        .action(async (name, opts) => {
+        output(await getClient().getEntityHistory(name, parseInt(opts.limit)), getFormat());
+    });
+    entities
+        .command("search-traits")
+        .description("Search entities by trait pattern (use --<trait-name> or --no-<trait-name>)")
+        .option("-l, --limit <n>", "Max results", "100")
+        .allowUnknownOption(true)
+        .action(async function () {
+        const rawArgs = this.args;
+        const query = {};
+        let limit = "100";
+        for (let i = 0; i < rawArgs.length; i++) {
+            const arg = rawArgs[i];
+            if (arg === "--limit" || arg === "-l") {
+                limit = rawArgs[++i] ?? "100";
+                continue;
+            }
+            // --trait-name or --no-trait-name
+            const noMatch = arg.match(/^--no-(.+)$/);
+            const yesMatch = arg.match(/^--(.+)$/);
+            if (noMatch) {
+                const trait = noMatch[1].replace(/-/g, "_");
+                if (TRAIT_NAMES.includes(trait))
+                    query[trait] = "false";
+            }
+            else if (yesMatch) {
+                const trait = yesMatch[1].replace(/-/g, "_");
+                if (TRAIT_NAMES.includes(trait))
+                    query[trait] = "true";
+            }
+        }
+        query["limit"] = limit;
+        output(await getClient().searchByTraits(query), getFormat());
+    });
+}
+//# sourceMappingURL=entities.js.map

package/dist/commands/entities.js.map

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

package/dist/commands/facts.d.ts

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

package/dist/commands/facts.js

@@ -0,0 +1,130 @@
+import { readFileSync } from "node:fs";
+import { output } from "../output.js";
+export function registerFactCommands(program, getClient, getFormat) {
+    const facts = program
+        .command("facts")
+        .description("Fact management commands");
+    facts
+        .command("store")
+        .description("Store a fact in the knowledge graph")
+        .argument("<subject>", "Subject of the fact")
+        .argument("<predicate>", "Relationship/predicate")
+        .argument("<object>", "Object value")
+        .option("-u, --user <id>", "User ID", "default")
+        .option("-n, --namespace <ns>", "Namespace")
+        .action(async (subject, predicate, object, opts) => {
+        output(await getClient().storeFact(subject, predicate, object, {
+            user_id: opts.user,
+            namespace: opts.namespace,
+        }), getFormat());
+    });
+    facts
+        .command("store-bulk")
+        .description("Store multiple facts from a JSON file")
+        .option("-f, --file <path>", "JSON file with array of facts (or - for stdin)")
+        .option("-n, --namespace <ns>", "Default namespace for all facts (overridden by per-fact namespace)")
+        .action(async (opts) => {
+        let data;
+        if (!opts.file || opts.file === "-") {
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            data = Buffer.concat(chunks).toString("utf-8");
+        }
+        else {
+            data = readFileSync(opts.file, "utf-8");
+        }
+        let parsed = JSON.parse(data);
+        // Apply default namespace if provided and fact doesn't already have one
+        if (opts.namespace) {
+            parsed = parsed.map(f => ({ ...f, namespace: f.namespace || opts.namespace }));
+        }
+        output(await getClient().storeFactsBulk(parsed), getFormat());
+    });
+    facts
+        .command("upsert")
+        .description("Upsert a fact (create or update)")
+        .argument("<subject>", "Subject of the fact")
+        .argument("<predicate>", "Relationship/predicate")
+        .argument("<object>", "Object value")
+        .option("-u, --user <id>", "User ID", "default")
+        .option("-n, --namespace <ns>", "Namespace")
+        .action(async (subject, predicate, object, opts) => {
+        output(await getClient().upsertFact(subject, predicate, object, {
+            user_id: opts.user,
+            namespace: opts.namespace,
+        }), getFormat());
+    });
+    facts
+        .command("query")
+        .description("Query facts with flexible filters")
+        .option("-s, --subject <subject>", "Filter by subject")
+        .option("-o, --object <object>", "Filter by object value")
+        .option("-p, --predicate <predicate>", "Filter by predicate")
+        .option("-c, --category <category>", "Filter by category")
+        .option("-u, --user <id>", "Filter by user ID")
+        .option("-n, --namespace <ns>", "Filter by namespace")
+        .option("-l, --limit <n>", "Max results (or 'all')", "50")
+        .action(async (opts) => {
+        const limit = opts.limit.toLowerCase() === "all" ? 10000 : parseInt(opts.limit) || 50;
+        output(await getClient().queryFacts({
+            subject: opts.subject,
+            object_value: opts.object,
+            predicate: opts.predicate,
+            category: opts.category,
+            user_id: opts.user,
+            namespace: opts.namespace,
+            limit,
+        }), getFormat());
+    });
+    facts
+        .command("update")
+        .description("Update an existing fact")
+        .argument("<fact-id>", "UUID of the fact")
+        .option("-s, --subject <subject>", "New subject")
+        .option("-p, --predicate <predicate>", "New predicate")
+        .option("-o, --object <object>", "New object value")
+        .action(async (factId, opts) => {
+        output(await getClient().updateFact(factId, {
+            subject: opts.subject,
+            predicate: opts.predicate,
+            object_value: opts.object,
+        }), getFormat());
+    });
+    facts
+        .command("delete")
+        .description("Delete a fact from the knowledge graph")
+        .argument("<fact-id>", "UUID of the fact")
+        .action(async (factId) => {
+        output(await getClient().deleteFact(factId), getFormat());
+    });
+    facts
+        .command("user-context")
+        .description("Get stored facts and preferences for a user")
+        .option("-u, --user <id>", "User ID", "default")
+        .action(async (opts) => {
+        output(await getClient().getUserContext(opts.user), getFormat());
+    });
+    facts
+        .command("namespace-context")
+        .description("Get all entities and facts under a namespace")
+        .argument("<namespace>", "Namespace code")
+        .option("-u, --user <id>", "Filter facts by user ID")
+        .action(async (namespace, opts) => {
+        output(await getClient().getNamespaceContext(namespace, opts.user), getFormat());
+    });
+    facts
+        .command("reconcile")
+        .description("Reconcile UHT facts against AIRGen trace links")
+        .requiredOption("--namespace <ns>", "UHT namespace to reconcile")
+        .requiredOption("--tenant <slug>", "AIRGen tenant slug")
+        .requiredOption("--project <slug>", "AIRGen project slug")
+        .option("--airgen-url <url>", "AIRGen API URL (or set AIRGEN_API_URL)")
+        .option("--airgen-email <email>", "AIRGen email (or set AIRGEN_EMAIL)")
+        .option("--airgen-password <pw>", "AIRGen password (or set AIRGEN_PASSWORD)")
+        .action(async (opts) => {
+        output(await getClient().reconcileFacts(opts.namespace, opts.tenant, opts.project, { airgen_url: opts.airgenUrl, airgen_email: opts.airgenEmail, airgen_password: opts.airgenPassword }), getFormat());
+    });
+}
+//# sourceMappingURL=facts.js.map

package/dist/commands/facts.js.map

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

package/dist/commands/impact.d.ts

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

package/dist/commands/impact.js

@@ -0,0 +1,148 @@
+import { existsSync, readFileSync } from "node:fs";
+import { bold, cyan, green, red, yellow } from "../output.js";
+// --- Helpers ---
+function getActiveTraitNames(traits) {
+    return traits.filter((t) => t.present && t.name).map((t) => t.name);
+}
+function findFlippedTraits(oldTraits, newTraits) {
+    const flipped = [];
+    const oldMap = new Map(oldTraits.map((t) => [t.bit, t]));
+    for (const nt of newTraits) {
+        const ot = oldMap.get(nt.bit);
+        if (!ot)
+            continue;
+        if (ot.present && !nt.present && ot.name) {
+            flipped.push({ bit: nt.bit, name: ot.name, direction: "removed" });
+        }
+        else if (!ot.present && nt.present && nt.name) {
+            flipped.push({ bit: nt.bit, name: nt.name, direction: "added" });
+        }
+    }
+    return flipped;
+}
+// --- Core logic ---
+async function runImpact(client, diff) {
+    const added = [];
+    const removed = [];
+    const drift = [];
+    // Classify added requirements
+    const addedReqs = diff.added ?? [];
+    for (const req of addedReqs) {
+        const result = (await client.classify(req.text));
+        added.push({
+            ref: req.ref,
+            hex: result.hex_code,
+            text: req.text,
+            top_traits: getActiveTraitNames(result.traits),
+        });
+    }
+    // Classify removed requirements
+    const removedReqs = diff.removed ?? [];
+    for (const req of removedReqs) {
+        const result = (await client.classify(req.text));
+        removed.push({
+            ref: req.ref,
+            hex: result.hex_code,
+            text: req.text,
+            top_traits: getActiveTraitNames(result.traits),
+        });
+    }
+    // Classify both sides of modified requirements and detect drift
+    const modifiedReqs = diff.modified ?? [];
+    for (const req of modifiedReqs) {
+        const [oldResult, newResult] = (await Promise.all([
+            client.classify(req.old_text),
+            client.classify(req.new_text),
+        ]));
+        if (oldResult.hex_code !== newResult.hex_code) {
+            drift.push({
+                ref: req.ref,
+                old_hex: oldResult.hex_code,
+                new_hex: newResult.hex_code,
+                old_text: req.old_text,
+                new_text: req.new_text,
+                flipped_traits: findFlippedTraits(oldResult.traits, newResult.traits),
+            });
+        }
+    }
+    return {
+        summary: {
+            added: addedReqs.length,
+            removed: removedReqs.length,
+            modified: modifiedReqs.length,
+            semantic_drift: drift.length,
+        },
+        drift,
+        added,
+        removed,
+    };
+}
+// --- Pretty output ---
+function prettyPrintImpact(result) {
+    const s = result.summary;
+    const driftLabel = s.semantic_drift > 0
+        ? ` (${yellow(`${s.semantic_drift} with semantic drift`)})`
+        : "";
+    console.log(bold("Summary: ") +
+        `${green(`${s.added} added`)}, ${red(`${s.removed} removed`)}, ` +
+        `${cyan(`${s.modified} modified`)}${driftLabel}`);
+    if (result.drift.length) {
+        console.log(bold("\nSemantic Drift:"));
+        for (const d of result.drift) {
+            console.log(`  ${bold(d.ref)}  ${red(d.old_hex)} → ${green(d.new_hex)}`);
+            for (const f of d.flipped_traits) {
+                const arrow = f.direction === "added" ? green("+") : red("-");
+                console.log(`    ${arrow} ${f.name}`);
+            }
+        }
+    }
+    if (result.added.length) {
+        console.log(bold("\nAdded:"));
+        for (const a of result.added) {
+            console.log(`  ${bold(a.ref)}  ${cyan(a.hex)}  ${a.top_traits.join(", ")}`);
+        }
+    }
+    if (result.removed.length) {
+        console.log(bold("\nRemoved:"));
+        for (const r of result.removed) {
+            console.log(`  ${bold(r.ref)}  ${cyan(r.hex)}  ${r.top_traits.join(", ")}`);
+        }
+    }
+}
+// --- Command registration ---
+export function registerImpactCommand(program, getClient, getFormat) {
+    program
+        .command("impact")
+        .description("Analyse semantic impact of requirement changes from an airgen diff")
+        .requiredOption("--airgen-diff <path>", "Path to airgen diff JSON file (airgen diff --json)")
+        .option("--json", "Force JSON output")
+        .action(async (opts) => {
+        const filePath = opts.airgenDiff;
+        if (!existsSync(filePath)) {
+            console.error(`Error: File not found: ${filePath}`);
+            process.exit(1);
+        }
+        let diff;
+        try {
+            const raw = readFileSync(filePath, "utf-8");
+            diff = JSON.parse(raw);
+        }
+        catch {
+            console.error(`Error: Could not parse ${filePath} as JSON. Expected airgen diff format: { summary, added, removed, modified }`);
+            process.exit(1);
+        }
+        if (!diff.added && !diff.removed && !diff.modified) {
+            console.error(`Error: No added, removed, or modified arrays found in ${filePath}. Expected airgen diff format.`);
+            process.exit(1);
+        }
+        const result = await runImpact(getClient(), diff);
+        const format = opts.json ? "json" : getFormat();
+        if (format === "json") {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            prettyPrintImpact(result);
+        }
+    });
+}
+//# sourceMappingURL=impact.js.map

package/dist/commands/impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../../src/commands/impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAgEnE,kBAAkB;AAElB,SAAS,mBAAmB,CAAC,MAAuB;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,iBAAiB,CACxB,SAA0B,EAC1B,SAA0B;IAE1B,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,IAAI,EAAE,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qBAAqB;AAErB,KAAK,UAAU,SAAS,CAAC,MAAiB,EAAE,IAAgB;IAC1D,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAmB,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,GAAG,EAAE,MAAM,CAAC,QAAQ;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAmB,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,GAAG,EAAE,MAAM,CAAC,QAAQ;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC;YAChD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;SAC9B,CAAC,CAAqC,CAAC;QAExC,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE,SAAS,CAAC,QAAQ;gBAC3B,OAAO,EAAE,SAAS,CAAC,QAAQ;gBAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,cAAc,EAAE,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC;aACtE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,KAAK,EAAE,SAAS,CAAC,MAAM;YACvB,OAAO,EAAE,WAAW,CAAC,MAAM;YAC3B,QAAQ,EAAE,YAAY,CAAC,MAAM;YAC7B,cAAc,EAAE,KAAK,CAAC,MAAM;SAC7B;QACD,KAAK;QACL,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC;AAED,wBAAwB;AAExB,SAAS,iBAAiB,CAAC,MAAoB;IAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACzB,MAAM,UAAU,GAAG,CAAC,CAAC,cAAc,GAAG,CAAC;QACrC,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,sBAAsB,CAAC,GAAG;QAC3D,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,WAAW,CAAC;QACf,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,UAAU,CAAC,IAAI;QAChE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,WAAW,CAAC,GAAG,UAAU,EAAE,CACnD,CAAC;IAEF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACzE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC9D,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;AACH,CAAC;AAED,+BAA+B;AAE/B,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,SAA0B,EAC1B,SAAkC;IAElC,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oEAAoE,CAAC;SACjF,cAAc,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;SAC5F,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAA4C,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,IAAgB,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,0BAA0B,QAAQ,8EAA8E,CAAC,CAAC;YAChI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,yDAAyD,QAAQ,gCAAgC,CAAC,CAAC;YACjH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAChD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/info.d.ts

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

package/dist/commands/info.js

@@ -0,0 +1,35 @@
+import { output } from "../output.js";
+export function registerInfoCommands(program, getClient, getFormat) {
+    program
+        .command("info")
+        .description("Get system information and overview")
+        .action(async () => {
+        output(await getClient().info(), getFormat());
+    });
+    program
+        .command("traits")
+        .description("Get all 32 trait definitions")
+        .action(async () => {
+        output(await getClient().traits(), getFormat());
+    });
+    program
+        .command("trait-prompts")
+        .description("Get classifier prompts sent to the LLM (includes edge cases and examples)")
+        .option("-e, --entity <name>", "Entity name to substitute into prompts")
+        .option("-d, --description <desc>", "Entity description to substitute")
+        .option("-b, --bit <n>", "Single trait bit (1-32), or omit for all")
+        .action(async (opts) => {
+        output(await getClient().traitPrompts({
+            entity_name: opts.entity,
+            entity_description: opts.description,
+            bit: opts.bit ? parseInt(opts.bit) : undefined,
+        }), getFormat());
+    });
+    program
+        .command("patterns")
+        .description("Get reasoning patterns for tool orchestration")
+        .action(async () => {
+        output(await getClient().patterns(), getFormat());
+    });
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,SAA0B,EAC1B,SAAkC;IAElC,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,2EAA2E,CAAC;SACxF,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;SACvE,MAAM,CAAC,0BAA0B,EAAE,kCAAkC,CAAC;SACtE,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,IAA6D,EAAE,EAAE;QAC9E,MAAM,CACJ,MAAM,SAAS,EAAE,CAAC,YAAY,CAAC;YAC7B,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,kBAAkB,EAAE,IAAI,CAAC,WAAW;YACpC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;SAC/C,CAAC,EACF,SAAS,EAAE,CACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/namespaces.d.ts

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

package/dist/commands/namespaces.js

@@ -0,0 +1,34 @@
+import { output } from "../output.js";
+export function registerNamespaceCommands(program, getClient, getFormat) {
+    const ns = program
+        .command("namespaces")
+        .alias("ns")
+        .description("Namespace management commands");
+    ns.command("create")
+        .description("Create a new namespace")
+        .argument("<code>", "Unique namespace code (e.g. SE:aerospace)")
+        .argument("<name>", "Human-readable name")
+        .option("-d, --description <desc>", "Optional description")
+        .action(async (code, name, opts) => {
+        output(await getClient().createNamespace(code, name, opts.description), getFormat());
+    });
+    ns.command("list")
+        .description("List namespaces")
+        .option("-p, --parent <code>", "List children of this namespace")
+        .option("--descendants", "Include entire subtree", false)
+        .action(async (opts) => {
+        output(await getClient().listNamespaces({
+            parent: opts.parent,
+            include_descendants: opts.descendants,
+        }), getFormat());
+    });
+    ns.command("assign")
+        .description("Assign an entity to a namespace")
+        .argument("<entity>", "Entity name")
+        .argument("<namespace>", "Namespace code")
+        .option("--no-primary", "Do not set as primary namespace")
+        .action(async (entity, namespace, opts) => {
+        output(await getClient().assignNamespace(entity, namespace, opts.primary), getFormat());
+    });
+}
+//# sourceMappingURL=namespaces.js.map

package/dist/commands/namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../../src/commands/namespaces.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,yBAAyB,CACvC,OAAgB,EAChB,SAA0B,EAC1B,SAAkC;IAElC,MAAM,EAAE,GAAG,OAAO;SACf,OAAO,CAAC,YAAY,CAAC;SACrB,KAAK,CAAC,IAAI,CAAC;SACX,WAAW,CAAC,+BAA+B,CAAC,CAAC;IAEhD,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,wBAAwB,CAAC;SACrC,QAAQ,CAAC,QAAQ,EAAE,2CAA2C,CAAC;SAC/D,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;SACzC,MAAM,CAAC,0BAA0B,EAAE,sBAAsB,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAY,EAAE,IAA8B,EAAE,EAAE;QAC3E,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEL,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iBAAiB,CAAC;SAC9B,MAAM,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAChE,MAAM,CAAC,eAAe,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,IAA+C,EAAE,EAAE;QAChE,MAAM,CACJ,MAAM,SAAS,EAAE,CAAC,cAAc,CAAC;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,mBAAmB,EAAE,IAAI,CAAC,WAAW;SACtC,CAAC,EACF,SAAS,EAAE,CACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;SACnC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;SACzC,MAAM,CAAC,cAAc,EAAE,iCAAiC,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,SAAiB,EAAE,IAA0B,EAAE,EAAE;QAC9E,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACP,CAAC"}