nexarch 0.4.4 → 0.4.5

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.5";
 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/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.5" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

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