nexarch 0.5.8 → 0.5.10

package/dist/commands/init-agent.js

@@ -6,7 +6,7 @@ import { requireCredentials } from "../lib/credentials.js";
 import { fetchAgentRegistryOrThrow } from "../lib/agent-registry.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
 import { buildVersionAttributes } from "../lib/version-normalization.js";
-const CLI_VERSION = "0.5.8";
+const CLI_VERSION = "0.5.10";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -251,11 +251,13 @@ function injectGenericAgentConfig(registry) {
         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 (!existsSync(filePath)) {
+            writeFileSync(filePath, `${sectionBody}\n`, "utf8");
+            return [{ path: filePath, status: "injected" }];
+        }
+        const existing = readFileSync(filePath, "utf8");
         if (target.insertionMode === "replace_section") {
             const replaced = replaceInjectedSection(existing, sectionHeading, sectionBody);
             if (replaced !== existing) {
@@ -267,7 +269,25 @@ function injectGenericAgentConfig(registry) {
         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).");
+    const fallbackTemplate = templateByCode.get("nexarch_agent_registration_v1") ?? registry.instructionTemplates[0];
+    if (!fallbackTemplate)
+        return [];
+    const fallbackPath = join(process.cwd(), "AGENTS.md");
+    const sectionBody = fallbackTemplate.body.trim();
+    if (!existsSync(fallbackPath)) {
+        writeFileSync(fallbackPath, `${sectionBody}\n`, "utf8");
+        return [{ path: fallbackPath, status: "injected" }];
+    }
+    const existing = readFileSync(fallbackPath, "utf8");
+    const sectionHeading = "## Nexarch Agent Registration";
+    const replaced = replaceInjectedSection(existing, sectionHeading, sectionBody);
+    if (replaced !== existing) {
+        writeFileSync(fallbackPath, replaced, "utf8");
+        return [{ path: fallbackPath, status: "updated" }];
+    }
+    const separator = existing.endsWith("\n") ? "" : "\n";
+    writeFileSync(fallbackPath, existing + separator + sectionBody + "\n", "utf8");
+    return [{ path: fallbackPath, status: "injected" }];
 }
 export async function initAgent(args) {
     const asJson = parseFlag(args, "--json");
@@ -751,6 +771,15 @@ export async function initAgent(args) {
         ok: registration.ok,
         detail: registration.detail,
     });
+    checks.push({
+        name: "agent.instructions.injection",
+        ok: !registration.ok || agentConfigResults.length > 0,
+        detail: !registration.ok
+            ? "skipped (registration failed)"
+            : agentConfigResults.length > 0
+                ? `updated ${agentConfigResults.length} instruction target file(s)`
+                : "no runtime instruction target matched this repository (non-fatal; create AGENTS.md/CLAUDE.md or configure a generic target)",
+    });
     checks.push({
         name: "technology.components",
         ok: techComponents.ok,
@@ -846,17 +875,11 @@ export async function initAgent(args) {
             }
         }
         const hasInjectedAgentInstructions = agentConfigResults.some((r) => r.status === "injected" || r.status === "updated");
+        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`);
         if (hasInjectedAgentInstructions) {
-            if (!fromSetup) {
-                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`);
+            console.log("   (Registration instructions were already written into your agent config file.)");
         }
         if (!fromSetup && appDetection.detected) {
             console.log("\n➡ Optional next step: likely application detected in current directory.");

package/dist/commands/setup.js

@@ -64,4 +64,5 @@ export async function setup(args) {
         initAgentArgs.push("--from-setup");
     await initAgent(initAgentArgs);
     console.log("\nSetup complete: MCP client config + agent registration are now in place.");
+    console.log("\n➡ Next step: in your coding agent, run:\n\nrun npx nexarch@latest init-agent");
 }

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

package/package.json

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