nexarch 0.9.4 → 0.9.5

package/dist/commands/init-project.js

@@ -964,12 +964,34 @@ async function promptApplicationChoice(matches, allApps, suggested) {
 export async function initProject(args) {
     const asJson = parseFlag(args, "--json");
     const dryRun = parseFlag(args, "--dry-run");
+    const profileEnabled = parseFlag(args, "--profile");
     const commandStartedAt = Date.now();
+    const profile = {
+        enabled: profileEnabled,
+        startedAt: new Date(commandStartedAt).toISOString(),
+        events: [],
+        mcpCalls: [],
+        upsertBatches: {
+            entities: [],
+            relationships: [],
+        },
+    };
     const logProgress = (phase, details) => {
-        const elapsed = formatMs(Date.now() - commandStartedAt);
+        const atMs = Date.now() - commandStartedAt;
+        if (profileEnabled)
+            profile.events.push({ phase, atMs, details });
+        const elapsed = formatMs(atMs);
         const line = details ? `[init-project +${elapsed}] ${phase} — ${details}` : `[init-project +${elapsed}] ${phase}`;
         process.stderr.write(`${line}\n`);
     };
+    const callMcpProfiled = async (toolName, input, meta) => {
+        const startedAt = Date.now();
+        const result = await callMcpTool(toolName, input, mcpOpts);
+        if (profileEnabled) {
+            profile.mcpCalls.push({ tool: toolName, durationMs: Date.now() - startedAt, meta });
+        }
+        return result;
+    };
     const dirArg = parseOptionValue(args, "--dir") ?? process.cwd();
     const dir = resolvePath(dirArg);
     const nameOverride = parseOptionValue(args, "--name");
@@ -1030,7 +1052,7 @@ export async function initProject(args) {
     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 raw = await callMcpProfiled("nexarch_resolve_reference", { names: batch, companyId: creds.companyId }, { batchSize: batch.length });
         const data = parseToolText(raw);
         allResolveResults.push(...data.results);
     }
@@ -1070,7 +1092,7 @@ export async function initProject(args) {
         return;
     }
     logProgress("preflight.onboarding.check");
-    const onboardingRaw = await callMcpTool("nexarch_get_company_onboarding", {}, mcpOpts);
+    const onboardingRaw = await callMcpProfiled("nexarch_get_company_onboarding", {});
     const onboarding = parseToolText(onboardingRaw);
     if (onboarding.isComplete !== true) {
         const message = "Company onboarding is incomplete. Complete onboarding before running init-project.";
@@ -1083,7 +1105,7 @@ export async function initProject(args) {
     }
     // Policy bootstrap
     logProgress("preflight.policies.check");
-    const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {}, mcpOpts);
+    const policiesRaw = await callMcpProfiled("nexarch_get_applied_policies", {});
     const policies = parseToolText(policiesRaw);
     const policyBundleHash = policies.policyBundleHash ?? null;
     if (!policyBundleHash) {
@@ -1108,7 +1130,7 @@ export async function initProject(args) {
                 console.log(`\nUsing --application-ref target: ${projectExternalKey}`);
         }
         else {
-            const appsRaw = await callMcpTool("nexarch_list_entities", { entityTypeCode: "application", status: "active", limit: 500, companyId: creds.companyId }, mcpOpts);
+            const appsRaw = await callMcpProfiled("nexarch_list_entities", { entityTypeCode: "application", status: "active", limit: 500, companyId: creds.companyId }, { entityTypeCode: "application", limit: 500 });
             const appsData = parseToolText(appsRaw);
             const apps = (appsData.entities ?? []).filter((e) => (e.entityRef ?? e.externalKey));
             if (apps.length > 0) {
@@ -1125,18 +1147,40 @@ export async function initProject(args) {
                         console.log(`\nAuto-mapped to existing application: ${suggested.name} (${projectExternalKey})`);
                 }
                 else if (!interactiveAllowed) {
-                    if (highConfidence) {
-                        projectExternalKey = suggested.entityRef;
+                    const message = "Application mapping requires explicit choice in non-interactive mode. Pass --application-ref <entityRef> or --create-application (or run interactively).";
+                    const existingApplications = apps.slice(0, 25).map((a) => ({
+                        entityRef: a.entityRef ?? a.externalKey,
+                        name: a.name,
+                        entityTypeCode: a.entityTypeCode,
+                    }));
+                    if (asJson) {
+                        process.stdout.write(`${JSON.stringify({
+                            ok: true,
+                            status: "input_required",
+                            code: "APPLICATION_MAPPING_REQUIRED",
+                            message,
+                            suggested: suggested ?? null,
+                            candidates: matches.slice(0, 10),
+                            existingApplications,
+                            requiredInput: {
+                                applicationRefOption: "--application-ref <entityRef>",
+                                createOption: "--create-application",
+                            },
+                        }, null, 2)}\n`);
+                        return;
+                    }
+                    console.log("\nInput required before continuing:");
+                    console.log(`  ${message}`);
+                    if (suggested) {
+                        console.log(`  Suggested: ${suggested.name} (${suggested.entityRef}) score=${suggested.score.toFixed(2)}`);
                     }
-                    else if (autoMapApplication) {
-                        const message = "Ambiguous application mapping in non-interactive mode. Pass --application-ref or --create-application.";
-                        if (asJson) {
-                            process.stdout.write(`${JSON.stringify({ ok: false, error: "APPLICATION_MAPPING_AMBIGUOUS", message, candidates: matches.slice(0, 5) }, null, 2)}\n`);
-                            process.exitCode = 1;
-                            return;
+                    if (existingApplications.length > 0) {
+                        console.log("  Existing applications:");
+                        for (const app of existingApplications) {
+                            console.log(`    - ${app.name} (${app.entityRef})`);
                         }
-                        throw new Error(message);
                     }
+                    return;
                 }
                 else {
                     const chosen = await promptApplicationChoice(matches, apps, highConfidence ? suggested : null);
@@ -1299,7 +1343,7 @@ export async function initProject(args) {
     // Company org is accountable_for the top-level project entity
     let orgExternalKey = `organisation:${normalizeToken(creds.companyId)}`;
     try {
-        const orgRaw = await callMcpTool("nexarch_list_entities", { entityTypeCode: "organisation", status: "active", limit: 1, companyId: creds.companyId }, mcpOpts);
+        const orgRaw = await callMcpProfiled("nexarch_list_entities", { entityTypeCode: "organisation", status: "active", limit: 1, companyId: creds.companyId }, { entityTypeCode: "organisation", limit: 1 });
         const orgData = parseToolText(orgRaw);
         const org = (orgData.entities ?? [])[0];
         if (org?.entityRef || org?.externalKey)
@@ -1331,8 +1375,18 @@ export async function initProject(args) {
     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 entityBatchStartedAt = Date.now();
+        const entitiesRaw = await callMcpProfiled("nexarch_upsert_entities", { entities: chunk, agentContext, policyContext }, { batchIndex: i + 1, totalBatches: entityChunks.length, batchSize: chunk.length });
         const chunkResult = parseToolText(entitiesRaw);
+        if (profileEnabled) {
+            profile.upsertBatches.entities.push({
+                index: i + 1,
+                size: chunk.length,
+                durationMs: Date.now() - entityBatchStartedAt,
+                succeeded: Number(chunkResult.summary?.succeeded ?? 0),
+                failed: Number(chunkResult.summary?.failed ?? 0),
+            });
+        }
         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);
@@ -1350,8 +1404,18 @@ export async function initProject(args) {
         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 relBatchStartedAt = Date.now();
+            const relsRaw = await callMcpProfiled("nexarch_upsert_relationships", { relationships: chunk, agentContext, policyContext }, { batchIndex: i + 1, totalBatches: relationshipChunks.length, batchSize: chunk.length });
             const chunkResult = parseToolText(relsRaw);
+            if (profileEnabled) {
+                profile.upsertBatches.relationships.push({
+                    index: i + 1,
+                    size: chunk.length,
+                    durationMs: Date.now() - relBatchStartedAt,
+                    succeeded: Number(chunkResult.summary?.succeeded ?? 0),
+                    failed: Number(chunkResult.summary?.failed ?? 0),
+                });
+            }
             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);
@@ -1609,6 +1673,15 @@ ${subPkgSection}${adrSection}${gapCheckSection}`;
         entityErrors: entitiesResult.errors ?? [],
         relationshipErrors: relsResult?.errors ?? [],
         enrichmentTask,
+        profile: profileEnabled
+            ? {
+                startedAt: profile.startedAt,
+                totalDurationMs: Date.now() - commandStartedAt,
+                events: profile.events,
+                mcpCalls: profile.mcpCalls,
+                upsertBatches: profile.upsertBatches,
+            }
+            : undefined,
     };
     if (asJson) {
         logProgress("complete", `ok=${output.ok}`);

package/dist/index.js

@@ -95,6 +95,7 @@ Usage:
                                --auto-map-application  auto-map only when high confidence
                                --non-interactive  fail on ambiguous mapping
                                --batch-size <n>  upsert batch size (default: 10)
+                               --profile  include timing/profile data in JSON output
                                --dry-run  preview without writing
                                --json
   nexarch update-entity

package/package.json

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