nexarch 0.5.2 → 0.5.4

package/dist/commands/init-agent.js

@@ -1,11 +1,11 @@
 import { arch, homedir, hostname, platform, release, type as osType, userInfo } from "os";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
 import { join } from "path";
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { fetchAgentRegistryOrThrow } from "../lib/agent-registry.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
-const CLI_VERSION = "0.5.2";
+const CLI_VERSION = "0.5.4";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -47,6 +47,32 @@ function getRuntimeMode() {
         return "ci";
     return "interactive";
 }
+function detectLikelyApplicationInCwd() {
+    const cwd = process.cwd();
+    const files = [
+        "package.json",
+        "pyproject.toml",
+        "requirements.txt",
+        "go.mod",
+        "Cargo.toml",
+        "Gemfile",
+        "composer.json",
+        "pom.xml",
+        "build.gradle",
+        "build.gradle.kts",
+    ];
+    const evidence = files.filter((file) => existsSync(join(cwd, file)));
+    try {
+        const entries = readdirSync(cwd);
+        if (entries.some((name) => name.toLowerCase().endsWith(".csproj"))) {
+            evidence.push("*.csproj");
+        }
+    }
+    catch {
+        // non-fatal; ignore
+    }
+    return { detected: evidence.length > 0, evidence };
+}
 function getSanitizedHostname(redactHostname) {
     const raw = hostname() || "unknown-host";
     return redactHostname ? "redacted" : raw;
@@ -245,6 +271,7 @@ function injectGenericAgentConfig(registry) {
 export async function initAgent(args) {
     const asJson = parseFlag(args, "--json");
     const strict = parseFlag(args, "--strict");
+    const fromSetup = parseFlag(args, "--from-setup");
     const redactHostname = parseFlag(args, "--redact-hostname");
     const explicitAgentId = parseOptionValue(args, "--agent-id");
     const bindToExternalKey = parseOptionValue(args, "--bind-to-external-key");
@@ -287,13 +314,23 @@ export async function initAgent(args) {
     });
     const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {}, { companyId: selectedCompanyId });
     const policies = parseToolText(policiesRaw);
+    const onboardingReady = Boolean(policies.policyBundleHash);
     checks.push({
         name: "governance.bootstrap",
-        ok: Boolean(policies.policyBundleHash),
+        ok: onboardingReady,
         detail: policies.policyBundleHash
-            ? `policyBundleHash=${policies.policyBundleHash.slice(0, 12)}… policyCount=${policies.policyCount ?? 0}`
+            ? `policyBundleHash=${policies.policyBundleHash.slice(0, 12)}…`
             : "missing policyBundleHash",
     });
+    if (!onboardingReady) {
+        const onboardingMessage = "Company onboarding is incomplete (missing policy bootstrap). Complete onboarding before running init-agent or init-project.";
+        if (asJson) {
+            process.stdout.write(`${JSON.stringify({ ok: false, error: "COMPANY_ONBOARDING_INCOMPLETE", message: onboardingMessage }, null, 2)}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        throw new Error(onboardingMessage);
+    }
     const contractRaw = await callMcpTool("nexarch_get_ingest_contract", {}, { companyId: selectedCompanyId });
     const contract = parseToolText(contractRaw);
     checks.push({
@@ -718,6 +755,7 @@ export async function initAgent(args) {
         });
     }
     const allPassed = checks.every((c) => c.ok);
+    const appDetection = detectLikelyApplicationInCwd();
     const identifyPrompt = [
         "Please identify your runtime so the workspace can register richer metadata.",
         "Return ONLY the completed command below with real values (no markdown):",
@@ -751,6 +789,17 @@ export async function initAgent(args) {
                 detail: "Prompt the coding agent to self-identify and submit via nexarch agent identify",
                 prompt: identifyPrompt,
                 submitCommandTemplate: `nexarch agent identify --agent-id \"${agentId}\" --provider \"<provider>\" --model \"<model>\" --client \"<client>\" --framework \"<openclaw|n8n|m365-agent-framework|other>\" --session-id \"<session-id>\" --tool-version \"<tool-version>\" --capabilities \"<capability1,capability2>\" --notes \"<optional notes>\" --json`,
+                initProjectSuggestion: appDetection.detected
+                    ? {
+                        shouldPromptUser: true,
+                        reason: `Detected likely project manifests in cwd: ${appDetection.evidence.join(", ")}`,
+                        userPrompt: "I found a likely application in this directory. Do you want me to run init-project next?",
+                        suggestedCommand: "npx nexarch@latest init-project --dir . --json",
+                    }
+                    : {
+                        shouldPromptUser: false,
+                        reason: "No common application manifest files detected in current directory.",
+                    },
             },
             companyId: creds.companyId,
             registry: { version: registry.release.version, registryVersion: registry.registryVersion, publishedAt: registry.release.publishedAt },
@@ -784,9 +833,11 @@ export async function initAgent(args) {
         }
         const hasInjectedAgentInstructions = agentConfigResults.some((r) => r.status === "injected" || r.status === "updated");
         if (hasInjectedAgentInstructions) {
-            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.)");
+            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");

package/dist/commands/init-project.js

@@ -5,7 +5,6 @@ import { basename, join, relative, resolve as resolvePath } from "node:path";
 import { homedir } from "node:os";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool } from "../lib/mcp.js";
-import { CURATED_AGENT_ICON_NAMES } from "../lib/application-icons.js";
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 function parseFlag(args, flag) {
     return args.includes(flag);
@@ -817,6 +816,15 @@ export async function initProject(args) {
     const policiesRaw = await callMcpTool("nexarch_get_applied_policies", {}, mcpOpts);
     const policies = parseToolText(policiesRaw);
     const policyBundleHash = policies.policyBundleHash ?? null;
+    if (!policyBundleHash) {
+        const message = "Company onboarding is incomplete (missing policy bootstrap). Complete onboarding before running init-project.";
+        if (asJson) {
+            process.stdout.write(`${JSON.stringify({ ok: false, error: "COMPANY_ONBOARDING_INCOMPLETE", message }, null, 2)}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        throw new Error(message);
+    }
     const nowIso = new Date().toISOString();
     const repoRef = repoRefOverride ?? detectedRepo?.rawRef ?? dir;
     const repoPath = repoPathOverride ?? dir;
@@ -988,7 +996,6 @@ export async function initProject(args) {
         const ecosystemLabel = detectedEcosystems.length > 0
             ? detectedEcosystems.join(", ")
             : "unknown";
-        const curatedIconList = CURATED_AGENT_ICON_NAMES.join(", ");
         const manifestHint = detectedEcosystems.includes("nodejs")
             ? "package.json"
             : detectedEcosystems.includes("python")
@@ -1022,9 +1029,9 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
       → --entity-type technology_component --subtype tech_library
 
   ICON ASSIGNMENT (applications only):
-    • Pick one icon from this curated set for each application/sub-app.
+    • Pick one icon from the full Lucide icon set for each application/sub-app.
     • If confidence is low, skip --icon rather than guessing.
-    • Allowed icons: ${curatedIconList}
+    • Use kebab-case icon names (example: server, workflow, shield-check).
 
   For each sub-package, run update-entity to register it:
 
@@ -1034,7 +1041,7 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
     --subtype "<chosen subtype>" \\
     --name "<human readable name>" \\
     --description "<what this package does and its role in the project>" \\
-    --icon "<curated icon>"   # applications only
+    --icon "<lucide icon>"   # applications only
 
   Then register it as a resolvable alias so future scans don't re-surface it as a candidate:
 
@@ -1158,8 +1165,7 @@ ${subPkgSection}${gapCheckSection}`;
         instructions: buildEnrichmentInstructions(),
         iconHints: {
             provider: "lucide",
-            curated: CURATED_AGENT_ICON_NAMES,
-            note: "Use curated list for agent-selected enrichment icons; omit icon when low confidence.",
+            note: "Use any Lucide icon name for agent-selected enrichment icons; omit icon when low confidence.",
         },
         projectEntity: {
             externalKey: projectExternalKey,

package/dist/commands/setup.js

@@ -59,6 +59,9 @@ export async function setup(args) {
         console.log("\nDone. Restart your MCP client for the changes to take effect.");
     }
     console.log("\nRegistering this runtime as a Nexarch agent…\n");
-    await initAgent(args.includes("--strict") ? args : [...args, "--strict"]);
+    const initAgentArgs = args.includes("--strict") ? [...args] : [...args, "--strict"];
+    if (!initAgentArgs.includes("--from-setup"))
+        initAgentArgs.push("--from-setup");
+    await initAgent(initAgentArgs);
     console.log("\nSetup complete: MCP client config + agent registration are now in place.");
 }

package/dist/commands/update-entity.js

@@ -1,7 +1,6 @@
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool } from "../lib/mcp.js";
-import { CURATED_AGENT_ICON_SET } from "../lib/application-icons.js";
 function parseFlag(args, flag) {
     return args.includes(flag);
 }
@@ -52,10 +51,6 @@ export async function updateEntity(args) {
     const policyContext = policyBundleHash
         ? { policyBundleHash, alignmentSummary: { score: 1, violations: [], waivers: [] } }
         : undefined;
-    if (iconName && !CURATED_AGENT_ICON_SET.has(iconName)) {
-        console.error(`error: --icon must be one of the curated agent icons (got '${iconName}')`);
-        process.exit(1);
-    }
     const entity = {
         externalKey,
         entityTypeCode,

package/dist/index.js

@@ -87,7 +87,7 @@ Usage:
                                --description <text>
                                --entity-type <code>  (default: application)
                                --subtype <code>
-                               --icon <lucide-name>  (curated set; for agent enrichment)
+                               --icon <lucide-name>  (full Lucide set; for agent enrichment)
                                --json
   nexarch add-relationship
                       Add a relationship between two existing graph entities.

package/package.json

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