nexarch 0.1.8 → 0.1.11

package/README.md

@@ -13,9 +13,9 @@ npx nexarch setup
 
 | Command | Description |
 |---|---|
-| `nexarch login` | Authenticate via browser and store credentials |
+| `nexarch login [--company <id>]` | Authenticate via browser and store company-scoped credentials; prompts for company when multiple memberships exist |
 | `nexarch logout` | Remove local credentials |
-| `nexarch status` | Check connection and show architecture summary |
+| `nexarch status` | Check connection and show architecture summary for the company selected at login |
 | `nexarch setup` | Auto-configure detected MCP clients |
 | `nexarch mcp-config [client]` | Print config block for manual setup (`claude-desktop`, `cursor`, `windsurf`) |
 | `nexarch mcp-proxy` | stdio→HTTP bridge used internally by MCP clients |
@@ -23,6 +23,13 @@ npx nexarch setup
 | `nexarch init-agent --bind-to-external-key <key> [--bind-relationship-type <code>]` | Optionally bind the agent node to an existing graph external key |
 | `nexarch init-agent` (default behavior) | Also upserts technology component entities (host, OS, Node.js runtime) and links them to the agent |
 
+## Company context behavior
+
+- Company is selected during `nexarch login`.
+- If your user has one active company, login auto-selects it.
+- If your user has multiple active companies, login requires explicit selection.
+- To switch company later, run `nexarch login` again and pick another company.
+
 ## Requirements
 
 - Node.js 18 or later

package/dist/commands/init-agent.js

@@ -2,7 +2,7 @@ import { arch, hostname, platform, release, type as osType, userInfo } from "os"
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
-const CLI_VERSION = "0.1.8";
+const CLI_VERSION = "0.1.11";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -80,7 +80,7 @@ async function emitInitObservation(params) {
                     waivers: [],
                 },
             },
-        });
+        }, { companyId: params.companyId });
     }
     catch {
         // non-fatal telemetry path
@@ -105,13 +105,14 @@ export async function initAgent(args) {
     };
     const checks = [];
     const creds = requireCredentials();
-    const init = await mcpInitialize();
+    const selectedCompanyId = creds.companyId;
+    const init = await mcpInitialize({ companyId: selectedCompanyId });
     checks.push({
         name: "mcp.initialize",
         ok: true,
         detail: `${init.serverInfo?.name ?? "unknown"}@${init.serverInfo?.version ?? "unknown"}`,
     });
-    const tools = await mcpListTools();
+    const tools = await mcpListTools({ companyId: selectedCompanyId });
     const toolNames = new Set(tools.map((t) => t.name));
     const required = [
         "nexarch_get_applied_policies",
@@ -126,7 +127,7 @@ export async function initAgent(args) {
         ok: missing.length === 0,
         detail: missing.length ? `missing: ${missing.join(", ")}` : `required tools present (${required.length})`,
     });
-    const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {});
+    const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {}, { companyId: selectedCompanyId });
     const policies = parseToolText(policiesRaw);
     checks.push({
         name: "governance.bootstrap",
@@ -135,7 +136,7 @@ export async function initAgent(args) {
             ? `policyBundleHash=${policies.policyBundleHash.slice(0, 12)}… policyCount=${policies.policyCount ?? 0}`
             : "missing policyBundleHash",
     });
-    const contractRaw = await callMcpTool("nexarch_get_ingest_contract", {});
+    const contractRaw = await callMcpTool("nexarch_get_ingest_contract", {}, { companyId: selectedCompanyId });
     const contract = parseToolText(contractRaw);
     checks.push({
         name: "ingest.contract",
@@ -243,7 +244,7 @@ export async function initAgent(args) {
                 },
             },
             dryRun: false,
-        });
+        }, { companyId: selectedCompanyId });
         const upsert = parseToolText(upsertRaw);
         const firstResult = upsert.results?.[0];
         const failed = Number(upsert.summary?.failed ?? 0) > 0;
@@ -259,6 +260,7 @@ export async function initAgent(args) {
         if (!registration.ok) {
             await emitInitObservation({
                 agentId,
+                companyId: selectedCompanyId,
                 policyBundleHash: policies.policyBundleHash,
                 message: `init-agent registration failed: ${registration.detail}`,
                 confidence: 1,
@@ -274,6 +276,7 @@ export async function initAgent(args) {
                     {
                         externalKey: hostExternalKey,
                         entityTypeCode: TECH_COMPONENT_ENTITY_TYPE,
+                        entitySubtypeCode: "tech_compute",
                         name: `Host ${runtime.hostname}`,
                         description: "Execution host for registered agent runtimes",
                         confidence: 0.95,
@@ -288,6 +291,7 @@ export async function initAgent(args) {
                     {
                         externalKey: osExternalKey,
                         entityTypeCode: TECH_COMPONENT_ENTITY_TYPE,
+                        entitySubtypeCode: "tech_operating_system",
                         name: `${runtime.osPlatform} ${runtime.osRelease}`,
                         description: "Operating system platform used by registered agents",
                         confidence: 0.95,
@@ -302,6 +306,7 @@ export async function initAgent(args) {
                     {
                         externalKey: nodeExternalKey,
                         entityTypeCode: TECH_COMPONENT_ENTITY_TYPE,
+                        entitySubtypeCode: "tech_runtime",
                         name: `Node.js ${runtime.nodeVersion}`,
                         description: "Node.js runtime used by nexarch-cli agent",
                         confidence: 0.95,
@@ -330,7 +335,7 @@ export async function initAgent(args) {
                     },
                 },
                 dryRun: false,
-            });
+            }, { companyId: selectedCompanyId });
             const techUpsert = parseToolText(techUpsertRaw);
             const techFailed = Number(techUpsert.summary?.failed ?? 0) > 0;
             techComponents = {
@@ -345,6 +350,7 @@ export async function initAgent(args) {
             if (!techComponents.ok) {
                 await emitInitObservation({
                     agentId,
+                    companyId: selectedCompanyId,
                     policyBundleHash: policies.policyBundleHash,
                     message: `init-agent technology component upsert failed: ${techComponents.detail}`,
                     confidence: 1,
@@ -394,7 +400,7 @@ export async function initAgent(args) {
                         },
                     },
                     dryRun: false,
-                });
+                }, { companyId: selectedCompanyId });
                 const relUpsert = parseToolText(techRelRaw);
                 const relFailed = Number(relUpsert.summary?.failed ?? 0) > 0;
                 techRelationships = {
@@ -409,6 +415,7 @@ export async function initAgent(args) {
                 if (!techRelationships.ok) {
                     await emitInitObservation({
                         agentId,
+                        companyId: selectedCompanyId,
                         policyBundleHash: policies.policyBundleHash,
                         message: `init-agent technology relationship upsert failed: ${techRelationships.detail}`,
                         confidence: 1,
@@ -449,7 +456,7 @@ export async function initAgent(args) {
                     },
                 },
                 dryRun: false,
-            });
+            }, { companyId: selectedCompanyId });
             const rel = parseToolText(relRaw);
             const relResult = rel.results?.[0];
             const relFailed = Number(rel.summary?.failed ?? 0) > 0;
@@ -466,6 +473,7 @@ export async function initAgent(args) {
             if (!binding.ok) {
                 await emitInitObservation({
                     agentId,
+                    companyId: selectedCompanyId,
                     policyBundleHash: policies.policyBundleHash,
                     message: `init-agent binding failed: ${binding.detail}`,
                     confidence: 1,

package/dist/commands/login.js

@@ -60,6 +60,8 @@ function waitForCallback(port, expectedState) {
             const state = url.searchParams.get("state");
             const token = url.searchParams.get("token");
             const companyId = url.searchParams.get("companyId");
+            const companyName = url.searchParams.get("companyName") ?? undefined;
+            const companyCode = url.searchParams.get("companyCode") ?? undefined;
             const error = url.searchParams.get("error");
             const html = (message) => `<!DOCTYPE html><html><head><meta charset="utf-8"><title>Nexarch CLI</title>
         <style>body{font-family:system-ui,sans-serif;display:flex;align-items:center;justify-content:center;min-height:100vh;margin:0;background:#f8fafc}
@@ -90,7 +92,7 @@ function waitForCallback(port, expectedState) {
             res.writeHead(200, { "Content-Type": "text/html" });
             res.end(html("Authorization successful! You can close this tab and return to your terminal."));
             server.close();
-            settle(() => resolve({ token, companyId }));
+            settle(() => resolve({ token, companyId, companyName, companyCode }));
         });
         const timeout = setTimeout(() => {
             server.close();
@@ -103,18 +105,38 @@ function waitForCallback(port, expectedState) {
         });
     });
 }
-export async function login(_args) {
+function getArgValue(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1)
+        return null;
+    const v = args[idx + 1];
+    if (!v || v.startsWith("--"))
+        return null;
+    return v;
+}
+export async function login(args) {
     const state = generateState();
     const port = await findFreePort();
-    const authUrl = `${NEXARCH_URL}/auth/cli?port=${port}&state=${state}`;
+    const requestedCompany = getArgValue(args, "--company");
+    const qp = new URLSearchParams({ port: String(port), state });
+    if (requestedCompany)
+        qp.set("company", requestedCompany);
+    const authUrl = `${NEXARCH_URL}/auth/cli?${qp.toString()}`;
     console.log("Opening Nexarch in your browser…");
     console.log(`\n  ${authUrl}\n`);
     console.log("If the browser did not open, copy the URL above and paste it in manually.\n");
     openBrowser(authUrl);
-    const { token, companyId } = await waitForCallback(port, state);
+    const { token, companyId, companyName, companyCode } = await waitForCallback(port, state);
     const expiresAt = new Date();
     expiresAt.setDate(expiresAt.getDate() + 90);
-    saveCredentials({ token, email: "", company: "", companyId, expiresAt: expiresAt.toISOString() });
+    saveCredentials({
+        token,
+        email: "",
+        company: companyName ?? companyCode ?? "",
+        companyCode: companyCode ?? undefined,
+        companyId,
+        expiresAt: expiresAt.toISOString(),
+    });
     console.log("✓ Logged in successfully");
     console.log("\nRun `nexarch status` to verify your connection.");
 }

package/dist/commands/status.js

@@ -2,14 +2,13 @@ import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool } from "../lib/mcp.js";
 export async function status(_args) {
     const creds = requireCredentials();
+    const selectedCompanyId = creds.companyId;
     const expiresAt = new Date(creds.expiresAt);
     const daysLeft = Math.ceil((expiresAt.getTime() - Date.now()) / (1000 * 60 * 60 * 24));
     process.stdout.write("Connecting to mcp.nexarch.ai… ");
     let governance;
     try {
-        const result = await callMcpTool("nexarch_get_governance_summary", {
-            companyId: creds.companyId || undefined,
-        });
+        const result = await callMcpTool("nexarch_get_governance_summary", { companyId: selectedCompanyId || undefined }, { companyId: selectedCompanyId || undefined });
         governance = JSON.parse(result.content[0]?.text ?? "{}");
     }
     catch (err) {

package/dist/index.js

@@ -23,7 +23,8 @@ async function main() {
 nexarch — Connect AI coding tools to your architecture workspace
 
 Usage:
-  nexarch login         Authenticate in the browser and store credentials
+  nexarch login         Authenticate in browser and store company-scoped credentials
+                        Option: --company <id>
   nexarch logout        Remove stored credentials
   nexarch status        Check connection and show architecture summary
   nexarch setup         Auto-configure your MCP client (Claude Desktop, Cursor, etc.)

package/dist/lib/mcp.js

@@ -2,8 +2,9 @@ import https from "https";
 import { requireCredentials } from "./credentials.js";
 const MCP_GATEWAY_URL = "https://mcp.nexarch.ai";
 const REQUEST_TIMEOUT_MS = 30 * 1000;
-async function callMcpRpc(method, params = {}) {
+async function callMcpRpc(method, params = {}, options = {}) {
     const creds = requireCredentials();
+    const companyId = options.companyId ?? creds.companyId;
     const body = JSON.stringify({
         jsonrpc: "2.0",
         id: 1,
@@ -20,7 +21,7 @@ async function callMcpRpc(method, params = {}) {
             headers: {
                 "Content-Type": "application/json",
                 Authorization: `Bearer ${creds.token}`,
-                "x-company-id": creds.companyId,
+                "x-company-id": companyId,
                 "Content-Length": Buffer.byteLength(body),
             },
             timeout: REQUEST_TIMEOUT_MS,
@@ -54,18 +55,18 @@ async function callMcpRpc(method, params = {}) {
         req.end();
     });
 }
-export async function callMcpTool(toolName, toolArgs = {}) {
-    return callMcpRpc("tools/call", { name: toolName, arguments: toolArgs });
+export async function callMcpTool(toolName, toolArgs = {}, options = {}) {
+    return callMcpRpc("tools/call", { name: toolName, arguments: toolArgs }, options);
 }
-export async function mcpInitialize() {
+export async function mcpInitialize(options = {}) {
     return callMcpRpc("initialize", {
         protocolVersion: "2024-11-05",
         capabilities: {},
-        clientInfo: { name: "nexarch-cli", version: "0.1.8" },
-    });
+        clientInfo: { name: "nexarch-cli", version: "0.1.11" },
+    }, options);
 }
-export async function mcpListTools() {
-    const result = await callMcpRpc("tools/list", {});
+export async function mcpListTools(options = {}) {
+    const result = await callMcpRpc("tools/list", {}, options);
     return result.tools ?? [];
 }
 export async function forwardToGateway(token, companyId, body) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexarch",
-  "version": "0.1.8",
+  "version": "0.1.11",
   "description": "Connect AI coding tools to your Nexarch architecture workspace",
   "keywords": [
     "nexarch",