nexarch 0.5.7 → 0.5.8

package/dist/commands/init-agent.js

@@ -5,7 +5,8 @@ import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { fetchAgentRegistryOrThrow } from "../lib/agent-registry.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
-const CLI_VERSION = "0.5.7";
+import { buildVersionAttributes } from "../lib/version-normalization.js";
+const CLI_VERSION = "0.5.8";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -516,7 +517,7 @@ export async function initAgent(args) {
                         attributes: {
                             kind: "runtime",
                             runtime: "nodejs",
-                            version: runtime.nodeVersion,
+                            ...buildVersionAttributes(runtime.nodeVersion, "runtime_probe"),
                         },
                     },
                 ],
@@ -582,7 +583,12 @@ export async function initAgent(args) {
                             fromEntityExternalKey: agentExternalKey,
                             toEntityExternalKey: nodeExternalKey,
                             confidence: 0.95,
-                            attributes: { source: "nexarch-cli-init-agent", kind: "runtime", createdAt: nowIso },
+                            attributes: {
+                                source: "nexarch-cli-init-agent",
+                                kind: "runtime",
+                                createdAt: nowIso,
+                                ...buildVersionAttributes(runtime.nodeVersion, "runtime_probe"),
+                            },
                         },
                         // Host runs on its OS — gives the host entity its own OS relationship
                         {

package/dist/commands/init-project.js

@@ -5,6 +5,7 @@ import { basename, join, relative, resolve as resolvePath } from "node:path";
 import { homedir } from "node:os";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool } from "../lib/mcp.js";
+import { buildVersionAttributes } from "../lib/version-normalization.js";
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 function parseFlag(args, flag) {
     return args.includes(flag);
@@ -290,10 +291,15 @@ function collectPackageDeps(pkgPath) {
     try {
         const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
         // devDependencies are build/test/type tooling — no architectural value
-        return Object.keys({
+        const merged = {
             ...pkg.dependencies,
             ...pkg.peerDependencies,
-        });
+        };
+        return Object.entries(merged).map(([name, versionRaw]) => ({
+            name,
+            versionRaw: typeof versionRaw === "string" ? versionRaw : null,
+            source: "package_json",
+        }));
     }
     catch {
         return [];
@@ -618,6 +624,7 @@ function scanProject(dir) {
     let projectName = basename(dir);
     const subPackages = [];
     let rootDepNames = new Set();
+    const rootDepVersions = new Map();
     const detectedEcosystems = [];
     // ── npm / Node.js ──────────────────────────────────────────────────────────
     const pkgPaths = findPackageJsonPaths(dir);
@@ -630,7 +637,9 @@ function scanProject(dir) {
             if (pkgPath === rootPkgPath) {
                 if (pkg.name)
                     projectName = pkg.name;
-                rootDepNames = new Set(deps);
+                rootDepNames = new Set(deps.map((d) => d.name));
+                for (const dep of deps)
+                    rootDepVersions.set(dep.name, dep);
             }
             else {
                 const relativePath = relative(dir, pkgPath)
@@ -642,14 +651,14 @@ function scanProject(dir) {
                     name: packageName,
                     relativePath,
                     packageJsonPath: pkgPath,
-                    depNames: deps,
+                    depSpecs: deps,
                     entityType,
                     subtype,
                     externalKey: "",
                 });
             }
             for (const dep of deps)
-                names.add(dep);
+                names.add(dep.name);
         }
     }
     // ── Other ecosystems (Python, Go, Ruby, Rust) ──────────────────────────────
@@ -660,8 +669,12 @@ function scanProject(dir) {
         if (!detectedEcosystems.includes(e))
             detectedEcosystems.push(e);
         // Root deps for non-npm ecosystems — treat all detected names as root-level
-        for (const n of ecosystemNames)
+        for (const n of ecosystemNames) {
             rootDepNames.add(n);
+            if (!rootDepVersions.has(n)) {
+                rootDepVersions.set(n, { name: n, versionRaw: null, source: `${e}_manifest` });
+            }
+        }
     }
     // Try to infer project name from Python pyproject.toml if no package.json name
     if (!detectedEcosystems.includes("nodejs") && existsSync(join(dir, "pyproject.toml"))) {
@@ -704,6 +717,7 @@ function scanProject(dir) {
         packageJsonCount: pkgPaths.length,
         detectedNames: Array.from(names),
         rootDepNames,
+        rootDepVersions,
         subPackages,
         detectedEcosystems,
     };
@@ -740,7 +754,7 @@ export async function initProject(args) {
     const mcpOpts = { companyId: creds.companyId };
     if (!asJson)
         console.log(`Scanning ${dir}…`);
-    const { projectName, packageJsonCount, detectedNames, rootDepNames, subPackages, detectedEcosystems } = scanProject(dir);
+    const { projectName, packageJsonCount, detectedNames, rootDepNames, rootDepVersions, subPackages, detectedEcosystems } = scanProject(dir);
     const detectedRepo = detectSourceRepository(dir);
     const displayName = nameOverride ?? projectName;
     const projectSlug = slugify(displayName);
@@ -944,12 +958,12 @@ export async function initProject(args) {
     // - Sub-packages that are apps → part_of the top-level project
     const relationships = [];
     const seenRelPairs = new Set();
-    function addRel(type, from, to, confidence = 0.9) {
+    function addRel(type, from, to, confidence = 0.9, attributes) {
         const key = `${type}::${from}::${to}`;
         if (seenRelPairs.has(key))
             return;
         seenRelPairs.add(key);
-        relationships.push({ relationshipTypeCode: type, fromEntityExternalKey: from, toEntityExternalKey: to, confidence });
+        relationships.push({ relationshipTypeCode: type, fromEntityExternalKey: from, toEntityExternalKey: to, confidence, attributes });
     }
     // Root-level deps → top-level project
     for (const r of resolvedItems) {
@@ -957,7 +971,12 @@ export async function initProject(args) {
             continue;
         if (!rootDepNames.has(r.input) && !rootDepNames.has(r.normalised))
             continue;
-        addRel(pickRelationshipType(r.entityTypeCode), projectExternalKey, r.canonicalExternalRef);
+        const depSpec = rootDepVersions.get(r.input) ?? rootDepVersions.get(r.normalised);
+        addRel(pickRelationshipType(r.entityTypeCode), projectExternalKey, r.canonicalExternalRef, 0.9, {
+            source: depSpec?.source ?? "manifest_scan",
+            detected_at: nowIso,
+            ...buildVersionAttributes(depSpec?.versionRaw ?? null, depSpec?.source ?? "manifest_scan"),
+        });
     }
     // Sub-package relationships
     for (const sp of subPackages) {
@@ -969,11 +988,15 @@ export async function initProject(args) {
             addRel("part_of", sp.externalKey, projectExternalKey);
         }
         // Wire each sub-package's resolved deps to itself
-        for (const depName of sp.depNames) {
-            const r = resolvedByInput.get(depName);
+        for (const dep of sp.depSpecs) {
+            const r = resolvedByInput.get(dep.name);
             if (!r?.canonicalExternalRef || !r.entityTypeCode)
                 continue;
-            addRel(pickRelationshipType(r.entityTypeCode, sp.entityType), sp.externalKey, r.canonicalExternalRef);
+            addRel(pickRelationshipType(r.entityTypeCode, sp.entityType), sp.externalKey, r.canonicalExternalRef, 0.9, {
+                source: dep.source,
+                detected_at: nowIso,
+                ...buildVersionAttributes(dep.versionRaw, dep.source),
+            });
         }
     }
     // Company org is accountable_for the top-level project entity
@@ -1089,8 +1112,8 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
 
   Pre-resolved dependencies per sub-package (wire these after registering each entity):
 ${subPackages.map((sp) => {
-            const resolved = sp.depNames
-                .map((d) => resolvedByInput.get(d))
+            const resolved = sp.depSpecs
+                .map((d) => resolvedByInput.get(d.name))
                 .filter((r) => !!r?.canonicalExternalRef);
             if (resolved.length === 0)
                 return `    • ${sp.name}: (no pre-resolved deps — check package.json manually)`;
@@ -1184,8 +1207,8 @@ ${subPkgSection}${gapCheckSection}`;
             readmeFiles: readmeHints,
         },
         subPackages: subPackages.map((sp) => {
-            const resolvedDeps = sp.depNames
-                .map((d) => resolvedByInput.get(d))
+            const resolvedDeps = sp.depSpecs
+                .map((d) => resolvedByInput.get(d.name))
                 .filter((r) => !!r?.canonicalExternalRef)
                 .map((r) => ({ canonicalExternalRef: r.canonicalExternalRef, canonicalName: r.canonicalName, entityTypeCode: r.entityTypeCode }));
             return {
@@ -1195,7 +1218,7 @@ ${subPkgSection}${gapCheckSection}`;
                 inferredEntityType: sp.entityType,
                 inferredSubtype: sp.subtype,
                 resolvedDeps,
-                unresolvedDeps: sp.depNames.filter((d) => !resolvedByInput.has(d)),
+                unresolvedDeps: sp.depSpecs.map((d) => d.name).filter((d) => !resolvedByInput.has(d)),
             };
         }),
     };

package/dist/lib/mcp.js

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

package/dist/lib/version-normalization.js

@@ -0,0 +1,35 @@
+export function normalizeVersion(raw) {
+    const value = typeof raw === "string" ? raw.trim() : "";
+    if (!value) {
+        return {
+            versionRaw: null,
+            versionNormalized: null,
+            versionMajor: null,
+            versionMinor: null,
+            isExact: false,
+        };
+    }
+    const withoutV = value.replace(/^v/i, "");
+    const exactMatch = withoutV.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:[-+][\w.-]+)?$/);
+    const majorMinorPatchMatch = withoutV.match(/(\d+)\.(\d+)(?:\.(\d+))?/);
+    const major = exactMatch?.[1] ?? majorMinorPatchMatch?.[1] ?? null;
+    const minor = exactMatch?.[2] ?? majorMinorPatchMatch?.[2] ?? null;
+    return {
+        versionRaw: value,
+        versionNormalized: exactMatch ? withoutV : (majorMinorPatchMatch ? majorMinorPatchMatch[0] : null),
+        versionMajor: major ? Number.parseInt(major, 10) : null,
+        versionMinor: minor ? Number.parseInt(minor, 10) : null,
+        isExact: Boolean(exactMatch),
+    };
+}
+export function buildVersionAttributes(raw, source) {
+    const normalized = normalizeVersion(raw);
+    return {
+        version_raw: normalized.versionRaw,
+        version_normalized: normalized.versionNormalized,
+        version_major: normalized.versionMajor,
+        version_minor: normalized.versionMinor,
+        version_is_exact: normalized.isExact,
+        version_source: source,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexarch",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "Your architecture workspace for AI delivery.",
   "keywords": [
     "nexarch",