nexarch 0.9.2 → 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

@@ -23,6 +23,19 @@ function parseToolText(result) {
     const text = result.content?.[0]?.text ?? "{}";
     return JSON.parse(text);
 }
+function formatMs(ms) {
+    if (ms < 1000)
+        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, "");
 }
@@ -951,6 +964,12 @@ async function promptApplicationChoice(matches, allApps, suggested) {
 export async function initProject(args) {
     const asJson = parseFlag(args, "--json");
     const dryRun = parseFlag(args, "--dry-run");
+    const commandStartedAt = Date.now();
+    const logProgress = (phase, details) => {
+        const elapsed = formatMs(Date.now() - commandStartedAt);
+        const line = details ? `[init-project +${elapsed}] ${phase} — ${details}` : `[init-project +${elapsed}] ${phase}`;
+        process.stderr.write(`${line}\n`);
+    };
     const dirArg = parseOptionValue(args, "--dir") ?? process.cwd();
     const dir = resolvePath(dirArg);
     const nameOverride = parseOptionValue(args, "--name");
@@ -962,11 +981,14 @@ 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)
         console.log(`Scanning ${dir}…`);
+    logProgress("scan.start", dir);
     const { projectName, packageJsonCount, detectedNames, rootDepNames, rootDepVersions, subPackages, detectedEcosystems } = scanProject(dir);
+    logProgress("scan.done", `packages=${packageJsonCount}, detectedNames=${detectedNames.length}, subPackages=${subPackages.length}`);
     const detectedRepo = detectSourceRepository(dir);
     const displayName = nameOverride ?? projectName;
     const projectSlug = slugify(displayName);
@@ -1004,12 +1026,15 @@ export async function initProject(args) {
         console.log("\nResolving against reference library…");
     const allResolveResults = [];
     const BATCH_SIZE = 200;
+    logProgress("resolve.start", `count=${detectedNames.length}, batchSize=${BATCH_SIZE}`);
     for (let i = 0; i < detectedNames.length; i += BATCH_SIZE) {
         const batch = detectedNames.slice(i, i + BATCH_SIZE);
+        logProgress("resolve.batch", `${Math.floor(i / BATCH_SIZE) + 1}/${Math.ceil(detectedNames.length / BATCH_SIZE)} size=${batch.length}`);
         const raw = await callMcpTool("nexarch_resolve_reference", { names: batch, companyId: creds.companyId }, mcpOpts);
         const data = parseToolText(raw);
         allResolveResults.push(...data.results);
     }
+    logProgress("resolve.done", `resolved=${allResolveResults.filter((r) => r.resolved).length}`);
     const resolvedItems = allResolveResults.filter((r) => r.resolved);
     const unresolvedItems = allResolveResults.filter((r) => !r.resolved);
     if (!asJson) {
@@ -1044,6 +1069,7 @@ export async function initProject(args) {
         process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
         return;
     }
+    logProgress("preflight.onboarding.check");
     const onboardingRaw = await callMcpTool("nexarch_get_company_onboarding", {}, mcpOpts);
     const onboarding = parseToolText(onboardingRaw);
     if (onboarding.isComplete !== true) {
@@ -1056,6 +1082,7 @@ export async function initProject(args) {
         throw new Error(message);
     }
     // Policy bootstrap
+    logProgress("preflight.policies.check");
     const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {}, mcpOpts);
     const policies = parseToolText(policiesRaw);
     const policyBundleHash = policies.policyBundleHash ?? null;
@@ -1125,6 +1152,7 @@ export async function initProject(args) {
             }
         }
     }
+    logProgress("application.target", projectExternalKey);
     const agentContext = {
         agentId: "nexarch-cli:init-project",
         agentRunId: `init-project-${Date.now()}`,
@@ -1293,14 +1321,45 @@ export async function initProject(args) {
     }
     if (!asJson)
         console.log(`\nWriting to graph…`);
-    // Upsert entities
-    const entitiesRaw = await callMcpTool("nexarch_upsert_entities", { entities, agentContext, policyContext }, mcpOpts);
-    const entitiesResult = parseToolText(entitiesRaw);
-    // Upsert relationships
+    // 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 (chunked)
     let relsResult = null;
     if (relationships.length > 0) {
-        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)
     const readmeHints = ["README.md", "README.mdx", "docs/README.md", "docs/index.md"]
@@ -1552,6 +1611,7 @@ ${subPkgSection}${adrSection}${gapCheckSection}`;
         enrichmentTask,
     };
     if (asJson) {
+        logProgress("complete", `ok=${output.ok}`);
         process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
         if (!output.ok)
             process.exitCode = 1;
@@ -1571,4 +1631,5 @@ ${subPkgSection}${adrSection}${gapCheckSection}`;
     }
     // ─── Enrichment task ────────────────────────────────────────────────────────
     console.log(enrichmentTask.instructions);
+    logProgress("complete", `ok=${output.ok}`);
 }

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.2",
+  "version": "0.9.4",
   "description": "Your architecture workspace for AI delivery.",
   "keywords": [
     "nexarch",