nexarch 0.8.12 → 0.8.14

package/dist/commands/init-agent.js

@@ -884,7 +884,7 @@ export async function initAgent(args) {
             identityCapture = {
                 attempted: false,
                 ok: false,
-                detail: `missing required identity fields: ${missingRequired.join(", ")}`,
+                detail: `identity input needed: ${missingRequired.join(", ")}`,
                 missingRequired,
             };
         }
@@ -978,10 +978,15 @@ export async function initAgent(args) {
         ok: registration.ok,
         detail: registration.detail,
     });
+    const needsIdentityInput = registration.ok && identityCapture.missingRequired.length > 0;
     checks.push({
         name: "agent.identity.capture",
-        ok: !registration.ok || identityCapture.ok,
-        detail: !registration.ok ? "skipped (registration failed)" : identityCapture.detail,
+        ok: !registration.ok || identityCapture.ok || needsIdentityInput,
+        detail: !registration.ok
+            ? "skipped (registration failed)"
+            : needsIdentityInput
+                ? `awaiting identity input (${identityCapture.missingRequired.join(", ")})`
+                : identityCapture.detail,
     });
     checks.push({
         name: "agent.instructions.injection",
@@ -1018,7 +1023,7 @@ export async function initAgent(args) {
             ok: strict ? allPassed : true,
             passed: allPassed,
             strict,
-            status: allPassed ? "completed" : "completed_with_issues",
+            status: needsIdentityInput ? "needs_identity_input" : (allPassed ? "completed" : "completed_with_issues"),
             checks,
             summary: {
                 total: checks.length,
@@ -1053,6 +1058,21 @@ export async function initAgent(args) {
                         reason: "No common application manifest files detected in current directory.",
                     },
             },
+            identityInputGuidance: needsIdentityInput
+                ? {
+                    missingRequired: identityCapture.missingRequired,
+                    guidance: "Collect provider, model, and client, then rerun init-agent with those flags.",
+                    preferredCommandTemplate: "npx nexarch@latest init-agent --provider \"<provider>\" --model \"<model>\" --client \"<client>\" --framework \"<optional>\" --tool-version \"<optional>\" --capabilities \"<optional,comma,separated>\" --notes \"<optional>\" --json",
+                }
+                : null,
+            instructionWriteGuidance: registration.ok && !instructionsWriteAllowed
+                ? {
+                    consentRequired: true,
+                    consentPrompt: "Nexarch can add setup instructions to AGENTS.md/CLAUDE.md so future AI sessions in this repo can self-register. Would you like me to do that?",
+                    ifApprovedCommand: "npx nexarch@latest init-agent --allow-instruction-write --json",
+                    activeFlag: "--allow-instruction-write",
+                }
+                : null,
             companyId: creds.companyId,
             registry: { version: registry.release.version, registryVersion: registry.registryVersion, publishedAt: registry.release.publishedAt },
             agentConfigs: agentConfigResults,
@@ -1087,6 +1107,19 @@ export async function initAgent(args) {
         if (hasInjectedAgentInstructions) {
             console.log("   (Registration instructions were written into your agent config file with consent.)");
         }
+        if (needsIdentityInput) {
+            console.log("\nℹ Additional identity details are still needed to complete agent profile enrichment.");
+            console.log(`   Missing: ${identityCapture.missingRequired.join(", ")}`);
+            console.log("   In an interactive terminal, rerun 'npx nexarch@latest init-agent' and answer prompts.");
+            console.log("   In non-interactive mode, rerun with: --provider --model --client");
+            console.log("   Example: npx nexarch@latest init-agent --provider \"<provider>\" --model \"<model>\" --client \"<client>\"");
+        }
+        if (registration.ok && !instructionsWriteAllowed) {
+            console.log("\n➡ Optional trusted-boundary step: AGENTS/CLAUDE instruction write requires user consent.");
+            console.log("   Consent prompt: 'Nexarch can add setup instructions to AGENTS.md/CLAUDE.md so future AI sessions in this repo can self-register. Would you like me to do that?'");
+            console.log("   If approved, rerun with: --allow-instruction-write");
+            console.log("   Example: npx nexarch@latest init-agent --allow-instruction-write");
+        }
         if (!fromSetup && appDetection.detected) {
             console.log("\n➡ Optional next step: likely application detected in current directory.");
             console.log(`   Detected manifests: ${appDetection.evidence.join(", ")}`);

package/package.json

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