nexarch 0.2.0 → 0.2.1

package/dist/commands/agent-identify.js

@@ -112,37 +112,52 @@ export async function agentIdentify(args) {
     const upsert = parseToolText(upsertRaw);
     const failed = Number(upsert.summary?.failed ?? 0) > 0;
     const firstResult = upsert.results?.[0];
-    // Upsert provider, model, and client as first-class graph entities
+    // Upsert provider, model, client, and (optionally) framework as first-class graph entities
     const providerExternalKey = `org:provider:${provider.toLowerCase().replace(/[^a-z0-9]+/g, "_")}`;
     const modelExternalKey = `model:${model.toLowerCase().replace(/[^a-z0-9]+/g, "_")}`;
     const clientExternalKey = `tool:client:${client.toLowerCase().replace(/[^a-z0-9]+/g, "_")}`;
+    const frameworkExternalKey = framework
+        ? `technology_component:framework:${framework.toLowerCase().replace(/[^a-z0-9]+/g, "_")}`
+        : null;
     const agentExternalKey = `agent:${agentId}`;
+    const identityEntities = [
+        {
+            externalKey: providerExternalKey,
+            entityTypeCode: "organisation",
+            entitySubtypeCode: "org_partner",
+            name: provider,
+            description: `AI provider: ${provider}`,
+            confidence: 1,
+        },
+        {
+            externalKey: modelExternalKey,
+            entityTypeCode: "model",
+            entitySubtypeCode: "model_llm",
+            name: model,
+            description: `Large language model: ${model}`,
+            confidence: 1,
+        },
+        {
+            externalKey: clientExternalKey,
+            entityTypeCode: "tool",
+            name: client,
+            description: `AI agent client: ${client}`,
+            confidence: 1,
+        },
+    ];
+    if (framework && frameworkExternalKey) {
+        identityEntities.push({
+            externalKey: frameworkExternalKey,
+            entityTypeCode: "technology_component",
+            entitySubtypeCode: "tool_agent_runtime",
+            name: framework,
+            description: `Agent framework: ${framework}`,
+            confidence: 1,
+            attributes: { kind: "agent_framework", framework },
+        });
+    }
     await callMcpTool("nexarch_upsert_entities", {
-        entities: [
-            {
-                externalKey: providerExternalKey,
-                entityTypeCode: "organisation",
-                entitySubtypeCode: "org_partner",
-                name: provider,
-                description: `AI provider: ${provider}`,
-                confidence: 1,
-            },
-            {
-                externalKey: modelExternalKey,
-                entityTypeCode: "model",
-                entitySubtypeCode: "model_llm",
-                name: model,
-                description: `Large language model: ${model}`,
-                confidence: 1,
-            },
-            {
-                externalKey: clientExternalKey,
-                entityTypeCode: "tool",
-                name: client,
-                description: `AI agent client: ${client}`,
-                confidence: 1,
-            },
-        ],
+        entities: identityEntities,
         agentContext: {
             agentId,
             agentRunId: `agent-identify-entities-${Date.now()}`,
@@ -160,28 +175,37 @@ export async function agentIdentify(args) {
             : undefined,
         dryRun: false,
     }, { companyId: creds.companyId });
-    // Wire relationships: uses_model, uses, accountable_for
+    // Wire relationships: uses_model, uses (client), accountable_for (provider), runs_on (framework)
+    const identityRelationships = [
+        {
+            relationshipTypeCode: "uses_model",
+            fromEntityExternalKey: agentExternalKey,
+            toEntityExternalKey: modelExternalKey,
+            confidence: 1,
+        },
+        {
+            relationshipTypeCode: "uses",
+            fromEntityExternalKey: agentExternalKey,
+            toEntityExternalKey: clientExternalKey,
+            confidence: 1,
+        },
+        {
+            relationshipTypeCode: "accountable_for",
+            fromEntityExternalKey: providerExternalKey,
+            toEntityExternalKey: agentExternalKey,
+            confidence: 1,
+        },
+    ];
+    if (framework && frameworkExternalKey) {
+        identityRelationships.push({
+            relationshipTypeCode: "runs_on",
+            fromEntityExternalKey: agentExternalKey,
+            toEntityExternalKey: frameworkExternalKey,
+            confidence: 1,
+        });
+    }
     await callMcpTool("nexarch_upsert_relationships", {
-        relationships: [
-            {
-                relationshipTypeCode: "uses_model",
-                fromEntityExternalKey: agentExternalKey,
-                toEntityExternalKey: modelExternalKey,
-                confidence: 1,
-            },
-            {
-                relationshipTypeCode: "uses",
-                fromEntityExternalKey: agentExternalKey,
-                toEntityExternalKey: clientExternalKey,
-                confidence: 1,
-            },
-            {
-                relationshipTypeCode: "accountable_for",
-                fromEntityExternalKey: providerExternalKey,
-                toEntityExternalKey: agentExternalKey,
-                confidence: 1,
-            },
-        ],
+        relationships: identityRelationships,
         agentContext: {
             agentId,
             agentRunId: `agent-identify-rels-${Date.now()}`,

package/dist/commands/init-agent.js

@@ -4,7 +4,7 @@ import { join } from "path";
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
-const CLI_VERSION = "0.2.0";
+const CLI_VERSION = "0.2.1";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -473,6 +473,14 @@ export async function initAgent(args) {
                             confidence: 0.95,
                             attributes: { source: "nexarch-cli-init-agent", kind: "runtime", createdAt: nowIso },
                         },
+                        // Host runs on its OS — gives the host entity its own OS relationship
+                        {
+                            relationshipTypeCode: "runs_on",
+                            fromEntityExternalKey: hostExternalKey,
+                            toEntityExternalKey: osExternalKey,
+                            confidence: 0.95,
+                            attributes: { source: "nexarch-cli-init-agent", kind: "host_os", createdAt: nowIso },
+                        },
                     ],
                     agentContext: {
                         agentId,

package/dist/lib/mcp.js

@@ -62,7 +62,7 @@ export async function mcpInitialize(options = {}) {
     return callMcpRpc("initialize", {
         protocolVersion: "2024-11-05",
         capabilities: {},
-        clientInfo: { name: "nexarch-cli", version: "0.1.11" },
+        clientInfo: { name: "nexarch-cli", version: "0.2.1" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

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