nexarch 0.4.4 → 0.4.6

package/dist/commands/agent-identify.js

@@ -33,6 +33,7 @@ function parseCsv(value) {
 export async function agentIdentify(args) {
     const asJson = parseFlag(args, "--json");
     const agentId = parseOptionValue(args, "--agent-id") ?? getDefaultAgentId();
+    const looksLikeUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(agentId);
     const provider = parseOptionValue(args, "--provider");
     const model = parseOptionValue(args, "--model");
     const client = parseOptionValue(args, "--client");
@@ -44,6 +45,9 @@ export async function agentIdentify(args) {
     if (!provider || !model || !client) {
         throw new Error("agent-identify requires --provider, --model, and --client");
     }
+    if (looksLikeUuid) {
+        throw new Error(`agent-identify expects the stable agent id (e.g. nexarch-cli:user@host), not a graph entity UUID (${agentId}). Re-run using --agent-id \"${getDefaultAgentId()}\" or omit --agent-id.`);
+    }
     const creds = requireCredentials();
     await mcpInitialize({ companyId: creds.companyId });
     const tools = await mcpListTools({ companyId: creds.companyId });

package/dist/commands/init-agent.js

@@ -5,7 +5,7 @@ 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.4.4";
+const CLI_VERSION = "0.4.6";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -214,6 +214,34 @@ function injectAgentConfigs(registry) {
     }
     return results;
 }
+function injectGenericAgentConfig(registry) {
+    const templateByCode = new Map(registry.instructionTemplates.map((t) => [t.code, t]));
+    const genericTargets = [...registry.instructionTargets]
+        .filter((t) => t.runtimeCode === "generic" && t.matchMode === "exact")
+        .sort((a, b) => a.sortOrder - b.sortOrder || a.filePathPattern.localeCompare(b.filePathPattern));
+    for (const target of genericTargets) {
+        const template = templateByCode.get(target.templateCode);
+        if (!template)
+            continue;
+        const filePath = join(process.cwd(), target.filePathPattern);
+        if (!existsSync(filePath))
+            continue;
+        const existing = readFileSync(filePath, "utf8");
+        const sectionBody = template.body.trim();
+        const sectionHeading = target.sectionHeading ?? "## Nexarch Agent Registration";
+        if (target.insertionMode === "replace_section") {
+            const replaced = replaceInjectedSection(existing, sectionHeading, sectionBody);
+            if (replaced !== existing) {
+                writeFileSync(filePath, replaced, "utf8");
+                return [{ path: filePath, status: "updated" }];
+            }
+        }
+        const separator = existing.endsWith("\n") ? "" : "\n";
+        writeFileSync(filePath, existing + separator + sectionBody + "\n", "utf8");
+        return [{ path: filePath, status: "injected" }];
+    }
+    throw new Error("No runtime instruction target matched this repository, and no generic target could be applied. Add a matching instruction target in the agent registry (or create the expected target file in this repo).");
+}
 export async function initAgent(args) {
     const asJson = parseFlag(args, "--json");
     const strict = parseFlag(args, "--strict");
@@ -651,7 +679,6 @@ export async function initAgent(args) {
             }
         }
     }
-    let bootstrapFilePath = null;
     let agentConfigResults = [];
     if (registration.ok) {
         try {
@@ -663,24 +690,9 @@ export async function initAgent(args) {
         catch {
             // non-fatal
         }
-        try {
-            bootstrapFilePath = writeAgentBootstrap({
-                agentId,
-                hostname: runtime.hostname,
-                osPlatform: runtime.osPlatform,
-                osRelease: runtime.osRelease,
-                nodeVersion: runtime.nodeVersion,
-                arch: runtime.arch,
-            });
-        }
-        catch {
-            // non-fatal
-        }
-        try {
-            agentConfigResults = injectAgentConfigs(registry);
-        }
-        catch {
-            // non-fatal
+        agentConfigResults = injectAgentConfigs(registry);
+        if (agentConfigResults.length === 0) {
+            agentConfigResults = injectGenericAgentConfig(registry);
         }
     }
     checks.push({
@@ -742,7 +754,6 @@ export async function initAgent(args) {
             },
             companyId: creds.companyId,
             registry: { version: registry.release.version, registryVersion: registry.registryVersion, publishedAt: registry.release.publishedAt },
-            bootstrapFile: bootstrapFilePath,
             agentConfigs: agentConfigResults,
         };
         process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
@@ -762,9 +773,7 @@ export async function initAgent(args) {
     console.log("");
     if (allPassed) {
         console.log("✅ Agent handshake + registration completed.");
-        if (bootstrapFilePath) {
-            console.log(`\n📋 Bootstrap instructions written to: ${bootstrapFilePath}`);
-        }
+        // instructions were injected from registry templates
         for (const r of agentConfigResults) {
             if (r.status === "injected") {
                 console.log(`📝 Nexarch registration instructions added to: ${r.path}`);
@@ -773,9 +782,17 @@ export async function initAgent(args) {
                 console.log(`📝 Nexarch registration instructions updated in: ${r.path}`);
             }
         }
-        console.log("\n➡ Next step (required): complete agent identity in your coding agent");
-        console.log("   Paste this and fill in real values:");
-        console.log(`\nrun npx nexarch@latest agent identify --agent-id \"${agentId}\" --provider \"<provider>\" --model \"<model>\" --client \"<client>\" --framework \"<openclaw|n8n|m365-agent-framework|other>\" --tool-version \"<tool-version>\" --capabilities \"<capability1,capability2>\" --json\n`);
+        const hasInjectedAgentInstructions = agentConfigResults.some((r) => r.status === "injected" || r.status === "updated");
+        if (hasInjectedAgentInstructions) {
+            console.log("\n➡ Next step: in your coding agent, run:");
+            console.log("\nrun npx nexarch@latest init-agent\n");
+            console.log("   (Registration instructions were already written into your agent config file.)");
+        }
+        else {
+            console.log("\n➡ Next step (required): complete agent identity in your coding agent");
+            console.log("   Paste this and fill in real values:");
+            console.log(`\nrun npx nexarch@latest agent identify --agent-id \"${agentId}\" --provider \"<provider>\" --model \"<model>\" --client \"<client>\" --framework \"<openclaw|n8n|m365-agent-framework|other>\" --tool-version \"<tool-version>\" --capabilities \"<capability1,capability2>\" --json\n`);
+        }
     }
     else {
         console.log("⚠ Handshake/registration completed with issues.");

package/dist/lib/agent-registry.js

@@ -44,6 +44,9 @@ export async function fetchAgentRegistryOrThrow() {
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
+        if (/token is invalid, expired, or revoked/i.test(message)) {
+            throw new Error("Your Nexarch session has expired. Run `nexarch login` and then retry `nexarch setup`.");
+        }
         throw new Error(`Nexarch integration registry unavailable. This command is blocked until service is restored. (${message})`);
     }
 }

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.4.4" },
+        clientInfo: { name: "nexarch-cli", version: "0.4.6" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

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