nexarch 0.1.21 → 0.1.23

package/dist/commands/add-relationship.js

@@ -0,0 +1,80 @@
+import process from "process";
+import { requireCredentials } from "../lib/credentials.js";
+import { callMcpTool } from "../lib/mcp.js";
+function parseFlag(args, flag) {
+    return args.includes(flag);
+}
+function parseOptionValue(args, option) {
+    const idx = args.indexOf(option);
+    if (idx === -1)
+        return null;
+    const value = args[idx + 1];
+    if (!value || value.startsWith("--"))
+        return null;
+    return value;
+}
+function parseToolText(result) {
+    const text = result.content?.[0]?.text ?? "{}";
+    return JSON.parse(text);
+}
+export async function addRelationship(args) {
+    const asJson = parseFlag(args, "--json");
+    const fromKey = parseOptionValue(args, "--from");
+    const toKey = parseOptionValue(args, "--to");
+    const relType = parseOptionValue(args, "--type");
+    if (!fromKey) {
+        console.error("error: --from <externalKey> is required");
+        process.exit(1);
+    }
+    if (!toKey) {
+        console.error("error: --to <externalKey> is required");
+        process.exit(1);
+    }
+    if (!relType) {
+        console.error("error: --type <relationshipTypeCode> is required");
+        process.exit(1);
+    }
+    const creds = requireCredentials();
+    const mcpOpts = { companyId: creds.companyId };
+    const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {}, mcpOpts);
+    const policies = parseToolText(policiesRaw);
+    const policyBundleHash = policies.policyBundleHash ?? null;
+    const nowIso = new Date().toISOString();
+    const agentContext = {
+        agentId: "nexarch-cli:add-relationship",
+        agentRunId: `add-relationship-${Date.now()}`,
+        repoRef: fromKey,
+        observedAt: nowIso,
+        source: "nexarch-cli",
+        model: "n/a",
+        provider: "n/a",
+    };
+    const policyContext = policyBundleHash
+        ? { policyBundleHash, alignmentSummary: { score: 1, violations: [], waivers: [] } }
+        : undefined;
+    const relationship = {
+        relationshipTypeCode: relType,
+        fromEntityExternalKey: fromKey,
+        toEntityExternalKey: toKey,
+        confidence: 1,
+    };
+    const raw = await callMcpTool("nexarch_upsert_relationships", { relationships: [relationship], agentContext, policyContext }, mcpOpts);
+    const result = parseToolText(raw);
+    if (asJson) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        if (Number(result.summary?.failed ?? 0) > 0)
+            process.exitCode = 1;
+        return;
+    }
+    const succeeded = result.summary?.succeeded ?? 0;
+    const failed = result.summary?.failed ?? 0;
+    if (failed > 0) {
+        console.error(`Failed to add relationship: ${fromKey} -[${relType}]-> ${toKey}`);
+        for (const err of result.errors ?? []) {
+            console.error(`  ${err.error} — ${err.message}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`Added ${succeeded} relationship: ${fromKey} -[${relType}]-> ${toKey}`);
+}

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.1.21";
+const CLI_VERSION = "0.1.23";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {

package/dist/commands/init-project.js

@@ -25,7 +25,7 @@ function slugify(name) {
 }
 // ─── Project scanning ─────────────────────────────────────────────────────────
 // Noise patterns for env var keys that are internal config, not external service references
-const ENV_KEY_NOISE = /^(NODE_ENV|PORT|HOST|DEBUG|LOG_LEVEL|TZ|LANG|PATH|HOME|USER|SHELL|TERM)$|(_LOG_LEVEL|_MAX_|_MIN_|_DEFAULT_|_TIMEOUT|_DELAY|_JOBS|_INTERVAL|_LIMIT|_RETRIES|_CONCURREN|_WORKERS)$|^NEXT_PUBLIC_(APP|ADMIN|API|SITE|BASE|WEB)_URL$/;
+const ENV_KEY_NOISE = /^(NODE_ENV|PORT|HOST|DEBUG|LOG_LEVEL|TZ|LANG|PATH|HOME|USER|SHELL|TERM)$|(_LOG_LEVEL|_MAX_|_MIN_|_DEFAULT_|_TIMEOUT|_DELAY|_JOBS|_INTERVAL|_LIMIT|_RETRIES|_CONCURREN|_WORKERS)$|^NEXT_PUBLIC_(APP|ADMIN|API|SITE|BASE|WEB)_URL$|(_URL|_SECRET|_TOKEN|_KEY|_PASSWORD|_CREDENTIAL|_DSN|_URI)$/;
 function parseEnvKeys(content) {
     return content
         .split("\n")
@@ -97,9 +97,9 @@ const SKIP_DIRS = new Set(["node_modules", "dist", ".next", ".turbo", "build", "
 function collectPackageDeps(pkgPath) {
     try {
         const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        // devDependencies are build/test/type tooling — no architectural value
         return Object.keys({
             ...pkg.dependencies,
-            ...pkg.devDependencies,
             ...pkg.peerDependencies,
         });
     }
@@ -465,7 +465,7 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
     Type definitions or utility package with no runtime
       → --entity-type technology_component --subtype tech_library
 
-  For each sub-package, run:
+  For each sub-package, run update-entity to register it:
 
   npx nexarch update-entity \\
     --key "<entity-type>:<slugified-package-name>" \\
@@ -474,10 +474,28 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
     --name "<human readable name>" \\
     --description "<what this package does and its role in the project>"
 
-  Then wire it to the parent project using the appropriate relationship:
-    • Deployable apps  → relationship type: part_of
-    • Shared libraries → relationship type: depends_on  (parent depends on the library)
+  Then register it as a resolvable alias so future scans don't re-surface it as a candidate:
 
-  (Note: add-relationship command is coming — skip wiring for now if unavailable)
+  npx nexarch register-alias \\
+    --alias "<original package name e.g. @scope/name>" \\
+    --key "<same entity-type>:<slugified-package-name>" \\
+    --name "<same human readable name>" \\
+    --entity-type "<same entity type>"
+
+  ⚠️  DIRECTION MATTERS — wire relationships as follows:
+
+  Deployable sub-apps (apps/*) are PART OF the parent — child points to parent:
+    npx nexarch add-relationship \\
+      --from "<sub-app-key>" \\
+      --to "${projectExternalKey}" \\
+      --type "part_of"
+    (FROM = the sub-app, TO = ${projectExternalKey})
+
+  Shared libraries (packages/*) are depended on by the parent — parent points to library:
+    npx nexarch add-relationship \\
+      --from "${projectExternalKey}" \\
+      --to "<library-key>" \\
+      --type "depends_on"
+    (FROM = ${projectExternalKey}, TO = the library)
 ` : ""}`);
 }

package/dist/commands/register-alias.js

@@ -0,0 +1,61 @@
+import process from "process";
+import { requireCredentials } from "../lib/credentials.js";
+import { callMcpTool } from "../lib/mcp.js";
+function parseFlag(args, flag) {
+    return args.includes(flag);
+}
+function parseOptionValue(args, option) {
+    const idx = args.indexOf(option);
+    if (idx === -1)
+        return null;
+    const value = args[idx + 1];
+    if (!value || value.startsWith("--"))
+        return null;
+    return value;
+}
+function parseToolText(result) {
+    const text = result.content?.[0]?.text ?? "{}";
+    return JSON.parse(text);
+}
+export async function registerAlias(args) {
+    const asJson = parseFlag(args, "--json");
+    const alias = parseOptionValue(args, "--alias");
+    const key = parseOptionValue(args, "--key");
+    const name = parseOptionValue(args, "--name");
+    const entityTypeCode = parseOptionValue(args, "--entity-type");
+    const entitySubtypeCode = parseOptionValue(args, "--subtype");
+    const description = parseOptionValue(args, "--description");
+    if (!alias) {
+        console.error("error: --alias <value> is required");
+        process.exit(1);
+    }
+    if (!key) {
+        console.error("error: --key <externalKey> is required");
+        process.exit(1);
+    }
+    if (!name) {
+        console.error("error: --name <name> is required");
+        process.exit(1);
+    }
+    if (!entityTypeCode) {
+        console.error("error: --entity-type <code> is required");
+        process.exit(1);
+    }
+    const creds = requireCredentials();
+    const mcpOpts = { companyId: creds.companyId };
+    const raw = await callMcpTool("nexarch_register_alias", {
+        alias,
+        canonicalExternalKey: key,
+        canonicalName: name,
+        entityTypeCode,
+        ...(entitySubtypeCode ? { entitySubtypeCode } : {}),
+        ...(description ? { description } : {}),
+        companyId: creds.companyId,
+    }, mcpOpts);
+    const result = parseToolText(raw);
+    if (asJson) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        return;
+    }
+    console.log(`Registered alias "${result.alias}" → ${result.canonicalExternalKey}`);
+}

package/dist/index.js

@@ -12,6 +12,8 @@ import { initAgent } from "./commands/init-agent.js";
 import { agentIdentify } from "./commands/agent-identify.js";
 import { initProject } from "./commands/init-project.js";
 import { updateEntity } from "./commands/update-entity.js";
+import { addRelationship } from "./commands/add-relationship.js";
+import { registerAlias } from "./commands/register-alias.js";
 const [, , command, ...args] = process.argv;
 const commands = {
     login,
@@ -24,6 +26,8 @@ const commands = {
     "agent-identify": agentIdentify,
     "init-project": initProject,
     "update-entity": updateEntity,
+    "add-relationship": addRelationship,
+    "register-alias": registerAlias,
 };
 async function main() {
     if (command === "agent") {
@@ -93,6 +97,23 @@ Usage:
                                --entity-type <code>  (default: application)
                                --subtype <code>
                                --json
+  nexarch add-relationship
+                      Add a relationship between two existing graph entities.
+                      Options: --from <externalKey>  (required)
+                               --to <externalKey>    (required)
+                               --type <code>         (required, e.g. part_of, depends_on)
+                               --json
+  nexarch register-alias
+                      Register a company-scoped alias for an entity so future
+                      scans resolve it instead of logging it as a candidate.
+                      Use after enriching internal monorepo packages.
+                      Options: --alias <value>       (required, e.g. @scope/name)
+                               --key <externalKey>   (required)
+                               --name <name>         (required)
+                               --entity-type <code>  (required)
+                               --subtype <code>
+                               --description <text>
+                               --json
     `);
         process.exit(command ? 1 : 0);
     }

package/package.json

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