nexarch 0.5.0 → 0.5.1

package/dist/commands/init-agent.js

@@ -5,7 +5,7 @@ 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.0";
+const CLI_VERSION = "0.5.1";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {

package/dist/commands/init-project.js

@@ -5,6 +5,7 @@ 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);
@@ -987,6 +988,7 @@ 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")
@@ -1019,6 +1021,11 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
     Type definitions or utility package with no runtime
       → --entity-type technology_component --subtype tech_library
 
+  ICON ASSIGNMENT (applications only):
+    • Pick one icon from this curated set for each application/sub-app.
+    • If confidence is low, skip --icon rather than guessing.
+    • Allowed icons: ${curatedIconList}
+
   For each sub-package, run update-entity to register it:
 
   npx nexarch update-entity \\
@@ -1026,7 +1033,8 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
     --entity-type "<chosen entity type>" \\
     --subtype "<chosen subtype>" \\
     --name "<human readable name>" \\
-    --description "<what this package does and its role in the project>"
+    --description "<what this package does and its role in the project>" \\
+    --icon "<curated icon>"   # applications only
 
   Then register it as a resolvable alias so future scans don't re-surface it as a candidate:
 
@@ -1141,13 +1149,18 @@ STEP 2 — Enrich the project entity. Run this command with the description you'
 
   npx nexarch update-entity \\
     --key "${projectExternalKey}" \\
-    --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? " \\\n    --subtype \"app_custom_built\"" : ""} \\
+    --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? " \\\n    --subtype \"app_custom_built\"\n    --icon \"<curated icon>\"" : ""} \\
     --name "<proper product name from README>" \\
     --description "<2–4 sentence summary of what it does and why>"
 ${subPkgSection}${gapCheckSection}`;
     }
     const enrichmentTask = {
         instructions: buildEnrichmentInstructions(),
+        iconHints: {
+            provider: "lucide",
+            curated: CURATED_AGENT_ICON_NAMES,
+            note: "Use curated list for agent-selected enrichment icons; omit icon when low confidence.",
+        },
         projectEntity: {
             externalKey: projectExternalKey,
             entityType: entityTypeOverride,

package/dist/commands/update-entity.js

@@ -1,6 +1,7 @@
 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);
 }
@@ -24,6 +25,7 @@ export async function updateEntity(args) {
     const description = parseOptionValue(args, "--description");
     const entityTypeCode = parseOptionValue(args, "--entity-type") ?? "application";
     const entitySubtypeCode = parseOptionValue(args, "--subtype");
+    const iconName = parseOptionValue(args, "--icon");
     if (!externalKey) {
         console.error("error: --key <externalKey> is required");
         process.exit(1);
@@ -50,6 +52,10 @@ 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,
@@ -61,6 +67,14 @@ export async function updateEntity(args) {
         entity.description = description;
     if (entitySubtypeCode)
         entity.entitySubtypeCode = entitySubtypeCode;
+    if (iconName) {
+        entity.attributes = {
+            application_icon: {
+                provider: "lucide",
+                name: iconName,
+            },
+        };
+    }
     const raw = await callMcpTool("nexarch_upsert_entities", { entities: [entity], agentContext, policyContext }, mcpOpts);
     const result = parseToolText(raw);
     if (asJson) {

package/dist/index.js

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

package/dist/lib/application-icons.js

@@ -0,0 +1,49 @@
+export const CURATED_AGENT_ICON_NAMES = [
+    "rocket",
+    "globe",
+    "monitor",
+    "smartphone",
+    "server",
+    "database",
+    "cloud",
+    "network",
+    "shield",
+    "lock",
+    "cpu",
+    "code",
+    "terminal",
+    "bug",
+    "flask-conical",
+    "bot",
+    "brain",
+    "sparkles",
+    "activity",
+    "gauge",
+    "clock-3",
+    "calendar",
+    "book-open",
+    "file-code",
+    "folder",
+    "search",
+    "filter",
+    "list-checks",
+    "kanban-square",
+    "layers",
+    "workflow",
+    "git-branch",
+    "package",
+    "wrench",
+    "settings",
+    "building-2",
+    "factory",
+    "store",
+    "map",
+    "users",
+    "briefcase",
+    "bar-chart-3",
+    "trending-up",
+    "target",
+    "leaf",
+    "heart-pulse",
+];
+export const CURATED_AGENT_ICON_SET = new Set(CURATED_AGENT_ICON_NAMES);

package/dist/lib/mcp.js

@@ -68,7 +68,7 @@ export async function mcpInitialize(options = {}) {
     return callMcpRpc("initialize", {
         protocolVersion: "2024-11-05",
         capabilities: {},
-        clientInfo: { name: "nexarch-cli", version: "0.5.0" },
+        clientInfo: { name: "nexarch-cli", version: "0.5.1" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

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