nexarch 0.5.0 → 0.5.2

package/dist/commands/check-in.js

@@ -35,11 +35,6 @@ function loadIdentity() {
         return { agentKey: null, projectKeys: [] };
     }
 }
-const COMMAND_TYPE_HINTS = {
-    policy_check: "Step 1: call nexarch_get_entity_policy_controls with entityExternalKey set to target_entity_key — this returns controls, each with a rules array (rule id, name, ruleText). Step 2: for each rule, examine the codebase and evaluate whether it passes, partially passes, or fails. Step 3: call nexarch_submit_policy_audit with applicationEntityKey, commandId, agentKey, and a findings array containing one entry per rule with policyControlId, policyRuleId, result (pass/partial/fail), rationale, and missingRequirements. Step 4: mark the command done with a brief summary. If no controls are returned, run command-fail with error 'No policy controls linked'.",
-    data_model_review: "Goal: infer enterprise canonical logical data assets and map concrete physical implementations. 1) Identify logical business entities (canonical names, singular, enterprise meaning) and upsert as data_asset:data_logical. 2) Identify physical stores (tables/collections/files/indexes) and upsert as data_asset:data_physical with attributes (database, schema, table_name, store_type, source_system). 3) Link logical -> physical via implemented_by. 4) Link apps/services to physical via reads/writes. 5) Link logical assets to data domains via belongs_to_domain where evidence exists. 6) Avoid duplicate logical entities: reuse canonical logical entities if concept already exists. 7) Mark uncertain mappings with lower confidence in attributes.confidence.score and include rationale in command summary.",
-    custom: "Execute the custom instructions provided.",
-};
 export async function checkIn(args) {
     const asJson = parseFlag(args, "--json");
     const agentKeyArg = parseOptionValue(args, "--agent-key");
@@ -66,8 +61,7 @@ export async function checkIn(args) {
     }, mcpOpts);
     const result = parseToolText(raw);
     if (asJson) {
-        const hint = result.command ? (COMMAND_TYPE_HINTS[result.command.command_type] ?? null) : null;
-        process.stdout.write(JSON.stringify({ ...result, hint }) + "\n");
+        process.stdout.write(JSON.stringify(result) + "\n");
         return;
     }
     if (!result.command) {
@@ -75,7 +69,6 @@ export async function checkIn(args) {
         return;
     }
     const cmd = result.command;
-    const hint = COMMAND_TYPE_HINTS[cmd.command_type] ?? "No built-in playbook for this command type. Follow the command instructions and complete/fail it explicitly.";
     console.log(`\n╔══════════════════════════════════════════════════════════════════╗`);
     console.log(`║  COMMAND QUEUED — action required                                ║`);
     console.log(`╚══════════════════════════════════════════════════════════════════╝`);
@@ -83,11 +76,17 @@ export async function checkIn(args) {
     console.log(`Type       : ${cmd.command_type}`);
     console.log(`Target     : ${cmd.target_entity_key ?? "(any)"}`);
     console.log(`Priority   : ${cmd.priority}`);
+    if (cmd.resolved_execution_mode)
+        console.log(`Mode       : ${cmd.resolved_execution_mode}`);
+    if (cmd.resolved_runtime_handler)
+        console.log(`Runtime    : ${cmd.resolved_runtime_handler}`);
+    if (cmd.command_type_version != null)
+        console.log(`Type ver   : ${cmd.command_type_version}`);
     if (Object.keys(cmd.command_params).length > 0) {
         console.log(`Params     : ${JSON.stringify(cmd.command_params)}`);
     }
-    if (hint) {
-        console.log(`\n${hint}`);
+    if (cmd.resolved_playbook_text?.trim()) {
+        console.log(`\nPlaybook:\n${cmd.resolved_playbook_text}`);
     }
     if (cmd.instructions) {
         console.log(`\nInstructions:\n${cmd.instructions}`);

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.2";
 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,303 @@
+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",
+    "beer",
+    "a-arrow-down",
+    "a-arrow-up",
+    "a-large-small",
+    "accessibility",
+    "activity-square",
+    "air-vent",
+    "airplay",
+    "alarm-check",
+    "alarm-clock",
+    "alarm-clock-check",
+    "alarm-clock-minus",
+    "alarm-clock-off",
+    "alarm-clock-plus",
+    "alarm-minus",
+    "alarm-plus",
+    "alarm-smoke",
+    "album",
+    "alert-circle",
+    "alert-octagon",
+    "alert-triangle",
+    "align-center",
+    "align-center-horizontal",
+    "align-center-vertical",
+    "align-end-horizontal",
+    "align-end-vertical",
+    "align-horizontal-distribute-center",
+    "align-horizontal-distribute-end",
+    "align-horizontal-distribute-start",
+    "align-horizontal-justify-center",
+    "align-horizontal-justify-end",
+    "align-horizontal-justify-start",
+    "align-horizontal-space-around",
+    "align-horizontal-space-between",
+    "align-justify",
+    "align-left",
+    "align-right",
+    "align-start-horizontal",
+    "align-start-vertical",
+    "align-vertical-distribute-center",
+    "align-vertical-distribute-end",
+    "align-vertical-distribute-start",
+    "align-vertical-justify-center",
+    "align-vertical-justify-end",
+    "align-vertical-justify-start",
+    "align-vertical-space-around",
+    "align-vertical-space-between",
+    "ambulance",
+    "ampersand",
+    "ampersands",
+    "amphora",
+    "anchor",
+    "angry",
+    "annoyed",
+    "antenna",
+    "anvil",
+    "aperture",
+    "app-window",
+    "app-window-mac",
+    "apple",
+    "archive",
+    "archive-restore",
+    "archive-x",
+    "area-chart",
+    "armchair",
+    "arrow-big-down",
+    "arrow-big-down-dash",
+    "arrow-big-left",
+    "arrow-big-left-dash",
+    "arrow-big-right",
+    "arrow-big-right-dash",
+    "arrow-big-up",
+    "arrow-big-up-dash",
+    "arrow-down",
+    "arrow-down-0-1",
+    "arrow-down-01",
+    "arrow-down-1-0",
+    "arrow-down-10",
+    "arrow-down-a-z",
+    "arrow-down-az",
+    "arrow-down-circle",
+    "arrow-down-from-line",
+    "arrow-down-left",
+    "arrow-down-left-from-circle",
+    "arrow-down-left-from-square",
+    "arrow-down-left-square",
+    "arrow-down-narrow-wide",
+    "arrow-down-right",
+    "arrow-down-right-from-circle",
+    "arrow-down-right-from-square",
+    "arrow-down-right-square",
+    "arrow-down-square",
+    "arrow-down-to-dot",
+    "arrow-down-to-line",
+    "arrow-down-up",
+    "arrow-down-wide-narrow",
+    "arrow-down-z-a",
+    "arrow-down-za",
+    "arrow-left",
+    "arrow-left-circle",
+    "arrow-left-from-line",
+    "arrow-left-right",
+    "arrow-left-square",
+    "arrow-left-to-line",
+    "arrow-right",
+    "arrow-right-circle",
+    "arrow-right-from-line",
+    "arrow-right-left",
+    "arrow-right-square",
+    "arrow-right-to-line",
+    "arrow-up",
+    "arrow-up-0-1",
+    "arrow-up-01",
+    "arrow-up-1-0",
+    "arrow-up-10",
+    "arrow-up-a-z",
+    "arrow-up-az",
+    "arrow-up-circle",
+    "arrow-up-down",
+    "arrow-up-from-dot",
+    "arrow-up-from-line",
+    "arrow-up-left",
+    "arrow-up-left-from-circle",
+    "arrow-up-left-from-square",
+    "arrow-up-left-square",
+    "arrow-up-narrow-wide",
+    "arrow-up-right",
+    "arrow-up-right-from-circle",
+    "arrow-up-right-from-square",
+    "arrow-up-right-square",
+    "arrow-up-square",
+    "arrow-up-to-line",
+    "arrow-up-wide-narrow",
+    "arrow-up-z-a",
+    "arrow-up-za",
+    "arrows-up-from-line",
+    "asterisk",
+    "asterisk-square",
+    "at-sign",
+    "atom",
+    "audio-lines",
+    "audio-waveform",
+    "award",
+    "axe",
+    "axis-3-d",
+    "axis-3d",
+    "baby",
+    "backpack",
+    "badge",
+    "badge-alert",
+    "badge-cent",
+    "badge-check",
+    "badge-dollar-sign",
+    "badge-euro",
+    "badge-help",
+    "badge-indian-rupee",
+    "badge-info",
+    "badge-japanese-yen",
+    "badge-minus",
+    "badge-percent",
+    "badge-plus",
+    "badge-pound-sterling",
+    "badge-question-mark",
+    "badge-russian-ruble",
+    "badge-swiss-franc",
+    "badge-turkish-lira",
+    "badge-x",
+    "baggage-claim",
+    "balloon",
+    "ban",
+    "banana",
+    "bandage",
+    "banknote",
+    "banknote-arrow-down",
+    "banknote-arrow-up",
+    "banknote-x",
+    "bar-chart",
+    "bar-chart-2",
+    "bar-chart-4",
+    "bar-chart-big",
+    "bar-chart-horizontal",
+    "bar-chart-horizontal-big",
+    "barcode",
+    "barrel",
+    "baseline",
+    "bath",
+    "battery",
+    "battery-charging",
+    "battery-full",
+    "battery-low",
+    "battery-medium",
+    "battery-plus",
+    "battery-warning",
+    "beaker",
+    "bean",
+    "bean-off",
+    "bed",
+    "bed-double",
+    "bed-single",
+    "beef",
+    "beef-off",
+    "beer-off",
+    "bell",
+    "bell-dot",
+    "bell-electric",
+    "bell-minus",
+    "bell-off",
+    "bell-plus",
+    "bell-ring",
+    "between-horizonal-end",
+    "between-horizonal-start",
+    "between-horizontal-end",
+    "between-horizontal-start",
+    "between-vertical-end",
+    "between-vertical-start",
+    "biceps-flexed",
+    "bike",
+    "binary",
+    "binoculars",
+    "biohazard",
+    "bird",
+    "birdhouse",
+    "bitcoin",
+    "blend",
+    "blinds",
+    "blocks",
+    "bluetooth",
+    "bluetooth-connected",
+    "bluetooth-off",
+    "bluetooth-searching",
+    "bold",
+    "bolt",
+    "bomb",
+    "bone",
+    "book",
+    "book-a",
+    "book-alert",
+    "book-audio",
+    "book-check",
+    "book-copy",
+    "book-dashed",
+    "book-down",
+    "book-headphones",
+    "book-heart",
+    "book-image",
+    "book-key",
+    "book-lock",
+    "book-marked",
+    "book-minus",
+    "book-open-check",
+    "book-open-text",
+    "book-plus",
+    "book-search",
+    "book-template",
+];
+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.2" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

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