nexarch 0.9.3 → 0.9.4

package/dist/commands/init-agent.js

@@ -59,12 +59,12 @@ async function promptForValue(promptText, required = false) {
         rl.close();
     }
 }
-async function confirmInstructionWrite() {
+async function confirmInstructionWrite(promptText = "Allow nexarch init-agent to write/update AGENTS.md/CLAUDE.md registration instructions? [y/N]: ") {
     if (!process.stdin.isTTY || !process.stdout.isTTY)
         return false;
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     try {
-        const answer = (await rl.question("Allow nexarch init-agent to write/update AGENTS.md/CLAUDE.md registration instructions? [y/N]: ")).trim().toLowerCase();
+        const answer = (await rl.question(promptText)).trim().toLowerCase();
         return answer === "y" || answer === "yes";
     }
     finally {
@@ -1084,20 +1084,25 @@ export async function initAgent(args) {
         catch {
             // non-fatal
         }
+        let existingInstructionTargets = injectAgentConfigs(registry);
+        if (existingInstructionTargets.length === 0) {
+            existingInstructionTargets = injectGenericAgentConfig(registry);
+        }
+        const alreadyConfigured = existingInstructionTargets.length > 0 && existingInstructionTargets.every((r) => r.status === "already_present");
         if (denyInstructionWriteFlag) {
             instructionsWriteAllowed = false;
         }
         else if (allowInstructionWriteFlag) {
             instructionsWriteAllowed = true;
         }
+        else if (alreadyConfigured) {
+            instructionsWriteAllowed = false;
+        }
         else if (!asJson) {
             instructionsWriteAllowed = await confirmInstructionWrite();
         }
         if (instructionsWriteAllowed) {
-            agentConfigResults = injectAgentConfigs(registry);
-            if (agentConfigResults.length === 0) {
-                agentConfigResults = injectGenericAgentConfig(registry);
-            }
+            agentConfigResults = existingInstructionTargets;
             if (agentConfigResults.length > 0) {
                 trustAttestationAttempted = true;
                 trustAttestation = await requestTrustAttestation(agentId);
@@ -1116,6 +1121,9 @@ export async function initAgent(args) {
                 }
             }
         }
+        else if (alreadyConfigured) {
+            agentConfigResults = existingInstructionTargets;
+        }
     }
     checks.push({
         name: "agent.registration",
@@ -1132,29 +1140,34 @@ export async function initAgent(args) {
                 ? `awaiting identity input (${identityCapture.missingRequired.join(", ")})`
                 : identityCapture.detail,
     });
+    const instructionsAlreadyConfigured = agentConfigResults.length > 0 && agentConfigResults.every((r) => r.status === "already_present");
     checks.push({
         name: "agent.instructions.injection",
         ok: !registration.ok || !instructionsWriteAllowed || agentConfigResults.length > 0,
         detail: !registration.ok
             ? "skipped (registration failed)"
-            : !instructionsWriteAllowed
-                ? "skipped (consent not granted)"
-                : 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)",
+            : instructionsAlreadyConfigured
+                ? "already configured (no write needed)"
+                : !instructionsWriteAllowed
+                    ? "skipped (consent not granted)"
+                    : 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: "agent.trust.attestation",
         ok: !registration.ok || !instructionsWriteAllowed || !trustAttestationAttempted || Boolean(trustAttestation?.ok),
         detail: !registration.ok
             ? "skipped (registration failed)"
-            : !instructionsWriteAllowed
-                ? "skipped (consent not granted)"
-                : !trustAttestationAttempted
-                    ? "skipped (no instruction target written)"
-                    : trustAttestation?.ok
-                        ? "minted and injected into instruction file(s)"
-                        : `unavailable (${trustAttestation?.reason ?? "unknown"})`,
+            : instructionsAlreadyConfigured && !instructionsWriteAllowed
+                ? "skipped (already configured)"
+                : !instructionsWriteAllowed
+                    ? "skipped (consent not granted)"
+                    : !trustAttestationAttempted
+                        ? "skipped (no instruction target written)"
+                        : trustAttestation?.ok
+                            ? "minted and injected into instruction file(s)"
+                            : `unavailable (${trustAttestation?.reason ?? "unknown"})`,
     });
     checks.push({
         name: "technology.components",

package/dist/commands/init-project.js

@@ -28,6 +28,14 @@ function formatMs(ms) {
         return `${ms}ms`;
     return `${(ms / 1000).toFixed(2)}s`;
 }
+function chunkArray(items, size) {
+    if (size <= 0)
+        return [items];
+    const chunks = [];
+    for (let i = 0; i < items.length; i += size)
+        chunks.push(items.slice(i, i + size));
+    return chunks;
+}
 function slugify(name) {
     return name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
 }
@@ -973,6 +981,7 @@ export async function initProject(args) {
     const forceCreateApplication = parseFlag(args, "--create-application");
     const autoMapApplication = parseFlag(args, "--auto-map-application");
     const nonInteractive = parseFlag(args, "--non-interactive");
+    const upsertBatchSize = Number(parseOptionValue(args, "--batch-size") ?? "10") || 10;
     const creds = requireCredentials();
     const mcpOpts = { companyId: creds.companyId };
     if (!asJson)
@@ -1312,17 +1321,44 @@ export async function initProject(args) {
     }
     if (!asJson)
         console.log(`\nWriting to graph…`);
-    // Upsert entities
-    logProgress("upsert.entities.start", `count=${entities.length}`);
-    const entitiesRaw = await callMcpTool("nexarch_upsert_entities", { entities, agentContext, policyContext }, mcpOpts);
-    const entitiesResult = parseToolText(entitiesRaw);
+    // Upsert entities (chunked for progressive feedback)
+    const entityChunks = chunkArray(entities, Math.max(1, upsertBatchSize));
+    const entitiesResult = {
+        summary: { requested: 0, succeeded: 0, failed: 0 },
+        errors: [],
+    };
+    logProgress("upsert.entities.start", `count=${entities.length}, batches=${entityChunks.length}, batchSize=${Math.max(1, upsertBatchSize)}`);
+    for (let i = 0; i < entityChunks.length; i += 1) {
+        const chunk = entityChunks[i];
+        logProgress("upsert.entities.batch.start", `${i + 1}/${entityChunks.length} size=${chunk.length}`);
+        const entitiesRaw = await callMcpTool("nexarch_upsert_entities", { entities: chunk, agentContext, policyContext }, mcpOpts);
+        const chunkResult = parseToolText(entitiesRaw);
+        entitiesResult.summary.requested = Number(entitiesResult.summary.requested ?? 0) + Number(chunkResult.summary?.requested ?? chunk.length);
+        entitiesResult.summary.succeeded = Number(entitiesResult.summary.succeeded ?? 0) + Number(chunkResult.summary?.succeeded ?? 0);
+        entitiesResult.summary.failed = Number(entitiesResult.summary.failed ?? 0) + Number(chunkResult.summary?.failed ?? 0);
+        if (chunkResult.errors?.length)
+            entitiesResult.errors.push(...chunkResult.errors);
+        logProgress("upsert.entities.batch.done", `${i + 1}/${entityChunks.length} succeeded=${chunkResult.summary?.succeeded ?? 0}, failed=${chunkResult.summary?.failed ?? 0}`);
+    }
     logProgress("upsert.entities.done", `succeeded=${entitiesResult.summary?.succeeded ?? 0}, failed=${entitiesResult.summary?.failed ?? 0}`);
-    // Upsert relationships
+    // Upsert relationships (chunked)
     let relsResult = null;
     if (relationships.length > 0) {
-        logProgress("upsert.relationships.start", `count=${relationships.length}`);
-        const relsRaw = await callMcpTool("nexarch_upsert_relationships", { relationships, agentContext, policyContext }, mcpOpts);
-        relsResult = parseToolText(relsRaw);
+        const relationshipChunks = chunkArray(relationships, Math.max(1, upsertBatchSize));
+        relsResult = { summary: { requested: 0, succeeded: 0, failed: 0 }, errors: [] };
+        logProgress("upsert.relationships.start", `count=${relationships.length}, batches=${relationshipChunks.length}, batchSize=${Math.max(1, upsertBatchSize)}`);
+        for (let i = 0; i < relationshipChunks.length; i += 1) {
+            const chunk = relationshipChunks[i];
+            logProgress("upsert.relationships.batch.start", `${i + 1}/${relationshipChunks.length} size=${chunk.length}`);
+            const relsRaw = await callMcpTool("nexarch_upsert_relationships", { relationships: chunk, agentContext, policyContext }, mcpOpts);
+            const chunkResult = parseToolText(relsRaw);
+            relsResult.summary.requested = Number(relsResult.summary.requested ?? 0) + Number(chunkResult.summary?.requested ?? chunk.length);
+            relsResult.summary.succeeded = Number(relsResult.summary.succeeded ?? 0) + Number(chunkResult.summary?.succeeded ?? 0);
+            relsResult.summary.failed = Number(relsResult.summary.failed ?? 0) + Number(chunkResult.summary?.failed ?? 0);
+            if (chunkResult.errors?.length)
+                relsResult.errors.push(...chunkResult.errors);
+            logProgress("upsert.relationships.batch.done", `${i + 1}/${relationshipChunks.length} succeeded=${chunkResult.summary?.succeeded ?? 0}, failed=${chunkResult.summary?.failed ?? 0}`);
+        }
         logProgress("upsert.relationships.done", `succeeded=${relsResult.summary?.succeeded ?? 0}, failed=${relsResult.summary?.failed ?? 0}`);
     }
     // Build structured enrichment task (included in JSON output and printed in human mode)

package/dist/index.js

@@ -94,6 +94,7 @@ Usage:
                                --create-application  force new application entity
                                --auto-map-application  auto-map only when high confidence
                                --non-interactive  fail on ambiguous mapping
+                               --batch-size <n>  upsert batch size (default: 10)
                                --dry-run  preview without writing
                                --json
   nexarch update-entity

package/package.json

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